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머 리 말 


위대한 령도자 김정 일 동지께서는 다음과 같이 지적하시였다. 

《프로그람을 개발하는데서 기본믄 우리 식의 프로그람을 개발하는것입니다. 우리는 
우리 식의 프로그람을 개발하는 방향으로 나가야 합니다.》 

(《김정일 선집》제I 5 권，1%폐지) 

오늘 우리 나라에서는 위대한 령도자 김정일 동지의 현명한 령도에 의하여 프로그람 
기술이 빠른 속도로 발전하고있다. 

우리의 과학자，연구사들은 우리 식 조작체계 《붉은별》을 개발하였으며 각종 도구 
들과 응용프로그람들을 개발하기 위한 연구사업을 활발히 진행하고있다. 

Qt 는 우리 식 조작체 계 《붉은별》과 함께 Linux, Unix, Windows, MAC O S X 
와 같은 여 러 가동환경 에 서 동작하는 GUI 프로그람을 개 발하기 위한 C++ 에 기 초하고있 
는 한조의 도구이 다. 

Qt 는 프로그람의 개 발을 쉽게 하고 고속화하기 위한 몇가지 지 령행도구들과 도형방 
식도구들을 제공한다. Qt 가 제공하는 도구들은 다음과 갈다. 

• Qt Designer - 시 각적 으로 폼을 설계 한다. 

• Qt Linguist, lupdate 와 lrelease - 다국어의 요구에 맞게 응용프로그람을 번역 한다. 

• Qt Assistant - 필요한 방조를 고속으로 검색 한다. 

• qmake - 단순한 가동환경에 의존하지 않는 프로젝트파일로부터 Makefile 를 창조 
한다. 

• qembed - 자료 실례로 화상들을 C++ 코드로 변환한다. 

• qvfb - 탁상우에 서 매 몰형 응용프로그람들을 실 행 하고 시 험한다. 

• makeqpf - 매 몰형 장치 용의 미 리 묘사된 서 체 들을 창조한다. 

• moc - 메 타객 체 틈파일 러 

• uic - 사용자대면부롬파일 러 

• qtconfig - 직결방조를 갖추고있는 Unix 에 기초한 Qt 환경구성도구 

이 책에서는 이상과 같이 Qt 에 포함되 여있는 각종 도구들의 사용방법을 서술한다. 

우리는 Qt 의 일반원리와 프로그람작성법을 습득함으로써 우리 식의 조작체계에서 실 
행할수 있는 프로그람들을 더 많이 개 발함으로써 나라의 프로그람기 술을 한계단 더 발전 
시키고 인민경제의 정보화를 실현하는데 적극 이바지하여야 한다. 
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제 1 장 . Qt Designer 


이 장에서는 Qt 다중가동환경 GUI 개발도구와 함께 구축된 사용자대면부의 설계 및 
실현도구인 Qt Designer 를 설명한다. Qt Designer 는 사용자대면부설계에 대한 실험을 
쉽게 해준다. Qt Designer 가 생성하는 파일들로부터 자기의 요구대로 설계를 변경하여 
사용자대면부를 복사하는데 필요한 코드를 생성 할수 있다. 낡은 판을 사용하였어도 대면 
부가 아주 류사하므로 새 판으로 즉시 만들수 있다. 그리 고 새로운 창문부품과 새 로 개 
선된 기능을 찾을수 있다. 

Qt Designer 는 실행시에 자동적으로 자기의 창문부품 (Windows 용어로 조종요소) 
들을 이동하거나 비례를 조절할수 있는 배치도구를 사용하여 사용자대면부를 만들수 있 
다. 결과로 생기는 대면부는 사용자의 조작환경과 애호에 가장 적합하다. Qt Designer 
는 창문부품들사이의 사건구동통신을 위한 Qt 의 신호-처리부기구를 지원한다. Qt 
Designer 는 생성된 코드안에 자기의 전용처리부를 매몰하는데 사용할수 있는 코드편집 
기를 포함하고있다. 생성된 코드를 손으로 작성한 코드와 분리하는것을 좋아하는 사람들 
은 초판의 Qt Designer 에서 개척된 파생들라스작성수법을 계속 리용할수 있다. 

이 장에서는 실례 응용프로그람들의 개 발을 통하여 Qt Designer 를 소개 한다. 처음 
8개 절들에서는 Qt 를 시작하는 방법과 기본응용프로그람, 대화칸，사용자정의창문부품, 
자료기지프로그람의 작성방법， Qt Designer 의 전용화와 통합방법을 설명한다. 

나머지 절들에서는 Qt Designer 의 차림표선택，도구띠，지름건，대화칸，위자드 
및 창문대화칸，위자드 및 창문에 대하여 설명한다. 

1. 무엇을 알아야 하는가 

이 책 은 C++ 와 Qt GUI 도구일식의 기 초지 식 을 가지 고있는것을 전제 로 하고있다. Qt 
의 Enterprise 판에 는 Qt SQL 모둘이 포함되 여 있 다. 자료기 지 응용프로그람작성 에 서 Qt 
Designer 를 리용한 SQL 응용프로그람건설방법에 대하여 보여준다. 이 절은 SQL 과 
관계형자료기지에 대한 지식을 요구한다. 

2. Qt 3.0 용 Qt Designer 에서 새로운것은 무엇인가? 

3.0 판의 Qt Designer 는 그 이전판보다 많은 기능을 가지고있다. 실례로 전용처 
리부용코드를 Qt Designer 에서 직접 편집할수 있고 작용, 도구띠，차림표를 가지는 
기본창문을 작성할수 있으며 분할기들을 결합하는 배치를 사용할수 있으며 플라그인은 
임의의 개수의 사용자정의창문부품들을 묶어서 그것들을 Qt Designer 에 쓸모있게 만 
들수 있다. 그밖에 사용자대면부의 자그마한 개량으로부터 효과성개선에 이르기까지 다 
른 많은 기능이 강화되였다. 

3.0 판의 Qt Designer 는 응용프로그람에 있는 모든 좀들사이의 절환과 자료기지 
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설정과 화상의 공통모임의 관리를 쉽게 하는 프로젝트파일을 도입한다. 파생콜라스작성 
이 완전히 유지되여도 Qt Designer 에서 코드의 직접쓰기는 4 절에서 학습한다. 또한 
새로운 서고 libqui 가 도입되여 Qt Designer 의 .ui 파일들로부터 실행시에 대화칸을 
동적으로 적재할수 있다. 이것은 응용프로그람의 사용자들에게 C ++ 를 사용하지 않고도 
상당한 대면부전용화능력을 제공하게 한다. 

3.0 판의 Qt Designer 가 새 수법들과 기술을 도입하였다. 단일대화칸설계도구가 
요구된다면 이것을 무시하고 Qt 2. 표에서 제공된 판을 사용할 때와 꼭같은 방법으로 간 
단히 사용할수 있다. 

1) Qt 3.1 용 Qt Designer 에서 새로운것은 무엇인가? 

• 현재 Qt Designer 는 최근에 사용한 파일들의 고속호출을 위한 기동대화칸을 
제공한다. (필요없다면 그 기능을 차단할수 있다.) 

• 신호-처리부대화칸은 변경되였다. 한번의 동작으로 많은 련결을 아주 쉽게 더 
빨리 작성할수 있다. 아직은 생성하려는 련결을 선택하고 끌기해야 하지만 새 대화칸은 
훨씬 고속이다. 

• 창문부품들은 현재 Toolbox 에 의하여 호출할수 있다. (모든 원시도구띠들을 여 
전히 쓸수 있다.) 이것은 도구띠단추와 갈은 간단한 호출을 제공하며 창문부품의 이름들 
을 보여주고 더 적은 공간을 차지한다. 

• QWidgetStack 는 현재 용기창문부품으로서 사용할수 있다. 새로운 실례는 그 사 
용법을 보여준다. 

• . ui.h 파일들은 현재 const 정의, # include , 일반함수 등 임의의 C ++ 원천을 
포함할수 있다. 

• 여러 창문부품들을 선택할 때 그것들의 공통속성들은 속성편집기에 표시되고 집 
체적으로 변경할수 있다. 

2) Qt 3. 2 용 Qt Designer 에서 새로운것은 무엇인가? 

• Qt 3.1 로부터 Qt Designer 에 의해 사용된 도구칸창문부품은 현재 자기의 프 
로그람에서 사용하기 위한 Qt 창문부품으로서 사용할수 있다. 그 창문부품을 QToolBox 
라고 부론다. 

• Qt Designer 의 차림표편집기는 다시 설계되여 응용프로그람의 기본창문들을 
시각적으로 간단히 만들수 있다. 

• 사용가능성과 련관된 소규모의 개량은 3.0 판에 아주 많다. 
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그림 1-1. Qt Designer 


제 i 절. 시작 

이 절에서는 사용자들이 Qt Designer 를 빨리 시작하기 위한 차림표를 제공한다. 
이 절에서 는 간단한 대 화칸형 식의 치 수변환프로그람의 작성 과정 을 하나하나 설명 한다. 
여기서는 픔에 창문부품의 추가, 창문부품속성의 설정, 신호와 처리부의 련결, 창문부품 
배치，그리고 전용코드의 추가에 대하여 설명한다. 이 절에서는 Qt Designer 의 기능과 
설명의 일부만 학습하며 구체적인것은 2절과 3절에서 소개하는 colortool 프로그람에서 
학습한다. 
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그림 1-2. Metric Conversion 대화칸 


1. Qt Designer 의 기동과 완료 

1) Windows 에서 Qt Designer 의 기동 

Windows 에서 Qt Designer 를 기동하려면 Start 단추를 찰칵하고 Programs | Qt 
X . x . x | Designer . 를 찰칵한다. ( X . x.x 는 Qt 판번호 례하면 3.3.1.) 

2) Unix 혹은 Linux 에서 Qt Designer 의 기동 

Qt Designer 는 사용하고있는 탁상환경에 따라서 여 러가지 방법으로 기동할수 있다. 

• 탁상배경 우에 Qt Designer 그림 기호가 있으면 그것을 두번 련속 찰칵하여 Qt 
Designer 를 기동할수 있다. 

• Start 차림표가 있는 탁상환경에서 련관된 보조차림표에 Qt Designer 항목이 있으면 
Programming 또는 Development 보조차림표에서 Qt Designer 항목을 찾아서 선택 한다. 

• 말단창문에서 designer 라고 입 력 하여 Qt Designer 를 기동할수도 있다. 

3) Mac OS 표에서 Qt Designer 의 기동 

Finder 안의 Qt Designer 를 련속 두번 찰칵한다. 

4) 완료 

Qt Designer 를 완료하려면 File | Exit 를 찰칵한다. 변경을 보관하지 않은 경우에 
그것을 보관하겠는가를 묻는 재촉문이 나 타난다. 

2. 프로젝트의 작성 

그러 면 Qt Designer 가 기 동된 다. Qt Designer 가 기 동하면 New/Open 대 화칸이 열 
린다. 이 대화칸을 자체로 열수 있으므로 Cancel 을 찰칵하여 그것을 닫는다. 

치 수변환응용프로그람은 표준 C ++ 응용프로그람이 므로 C ++ 프로젝 트를 만들고 여기 에 
파일들과 코드를 추가하여야 한다. 
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새 프로젝트를 다음과 같이 만든다. 

• FilelNew 를 찰칵하여 New File 대화칸을 표시한다. 

• C ++ Project 를 찰칵하여 C ++ 프로젝트를 작성한 다음 OK 를 찰칵하여 Project 
Settings 대화칸을 펼친다. 

• Project File 행 편집 칸 다음의 생략 (...) 단추를 찰칵하여 Save As 대화칸을 연다. 
이 대화칸을 사용하여 새로운 프로젝트를 만들려는 위치로 이행한다. 실제로는 Create 
New Folder 도구띠단추로 metric 라는 새 로운 홀더 를 만든다. 

• metric . pro 라는 파일이름을 입력하고 Save 를 찰칵한다. 프로젝트의 이름이 
metric 로 된다. 

• OK 를 찰칵하여 Project Settings 대화칸을 닫는다. 

• File | Save 를 찰칵하여 프로젝트를 보관한다. 



그림 1-3. Project Settings 대화칸 

1) 대화칸의 작성 

• FilelNew 를 찰칵하여 New File 대화칸을 연다. 

• Dialog 를 선택하고 OK 를 찰칵한다. 

• 새 픔의 모서 리를 끌기하여 좀 더 작게 만든다. 

• Property Editor 에서 폼의 이름을 ConversionForm 으로，제목을 Metric 
Conversion 으로 변경한다. 

• File | Save 를 찰칵하여 기정픔이름을 받아들이고 Save 를 찰칵하여 보관한다. 
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그림 1-4. 새로운 픔대화칸 
2) 대화칸에 창문부품들의 추가 
- 본문표식자의 추가 

• Qt Designer 의 기본창문의 왼쪽에 있는 Toolbox 도구띠에 렬거된 Common 
Widgets 단추를 찰칵한다. 

• TextLabel 단추를 련속 두번 찰칵하고 대화칸의 왼쪽웃모서 리를 찰칵한다. 
•우에서 아래로 내려오면서 5개의 표식자를 배치할 때까지 맨 꼭대기의 본문표식 

자아래에 4번 더 찰칵한다. 표식자들의 배치는 배치도구가 자동적으로 조종하므로 여기 
서 는 정 확히 배 치하지 않아도 된 다. 

• Pointer 도구띠 단추를 찰칵하여 본문표식 자의 선택 을 해 제 한다. 

이제는 응용프로그람에 적 합하게 본문표식 자들의 속성을 변경 한다. 

• 제일 우에 있는 본문표식자우를 찰칵한다. Property Editor 창문으로 가서 표식자 
의 text 속성을 Enter & Number : 로 변경한다. &는 다음 문자를 Alt 지름건으로 만든다. 

• 둘째 표식 자를 선택 하고 text 속성 을 Convert & From : 로 변경 한다. 

• 셋째 표식자를 선택하고 text 속성을 Convert "이로 변경한다. 

• 넷째 표식자를 선택하고 text 속성을 Result : 로 변경한다. 

• 다섯째 표식자를 선택하고 text 속성을 SDecimals : 로 변경한다. 

• File | Save 를 찰칵한다. 























그림 1-5. 대화칸에 표식자의 추가 
- 행편집칸과 복합칸，스핀 칸의 추가 

• Qt Designer 의 기본창문의 왼쪽에 있는 Toolbox 도구띠에 렬거된 Common 
Widgets 단추를 찰칵한다. 

• LineEdit 단추를 찰칵한 다음 Enter Number 표식자의 오른쪽을 찰칵한다. 그 
name 속성을 numberLineEdit 로， hAlign 속성을 AlignRight 로， vAlign 을 AlignTop 
로 변경한다. font 속성을 그것을 전개하여 bold 부분의 값을 조절할수 있게 강조가변 
(bold variant ) 으로 변경한다. 끝으로 wordwrap 를 False 로 변경한다. 창문부품을 찰 
칵할 때마다 그 속성 이 Property Editor 에 나타난다. 

• ComboBox 단추를 련속 두번 찰칵하고 Convert From 표식자의 오른쪽을 찰칵한 
다. Convert To 표식 자의 오른쪽을 찰칵한다. Pointer 도구띠 단추를 찰칵하여 
ComboBox 선택을 해제한다. 첫째 복합칸의 name 속성을 fromComboBox 로 변경한다. 
둘째 복합칸의 name 속성을 toComboBox 로 변경한다. 

• LineEdit 단추를 누른 다음 Result 표식자의 오른쪽을 찰칵한다. 그 name 속성을 
resultLineEdit 로 변경 한다. paletteBackgroundColor 속성을 누런색배경으로 하고 
font 속성을 강조체변경가능으로 수정하여 결과가 두드러지게 한다. hAlign 을 
AlignRight , vAlign 을 AlignVCenter , wordwrap 를 False 로 한다. readonly 속성 
을 True 로 변경한다. 

• SpinBox 단추를 찰칵한 다음 Decimals 표식자의 오른쪽을 찰칵한다. 
resultLineEdit 의 오른쪽아래에 SpinBox 를 배치한다. 스핀칸의 name 속성을 
decimalsSpinBox 로 변경하고 그 max value 속성을 6， value 를 3으로 변경한다. 

• File | Save 를 찰칵한다. 
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그림 1-6. 대화칸에 행편집, 복합칸，스핀칸의 추가 

이제는 매개 본문표식자를 대응하는 창문부품과 련결해 야 한다. 짝패 ( buddy ) 를 작 
성하여 이것을 수행한다. 

초점을 받아들이지 않는 창문부품 례하면 QLabel 은 짝패창문부품의 이름에 첫 창 
문부품의 buddy 속성을 설정함으로써 초점을 그 짝패，례를 들면 QLineEdit 에 넘기는 
지름건을 가질수 있다. 

• Set Buddy 도구띠 단추를 찰칵하거 나 F 12 건을 누른다. Enter Number 표식 자를 
누르고 선을 numberLineEdit 에로 끌어다놓는다. 

• Set Buddy 도구띠단추를 찰칵한다. Convert From 표식 자를 누르고 
fromComboBox 에로 선을 끌어다놓는다. 

• Set Buddy 도구띠 단추를 찰칵한다. Convert To 표식 자를 누르고 선을 
toComboBox 에 로 끌어 다놓는다. 

• Set Buddy 도구띠 단추를 찰칵한다. Decimals 표식 자를 누르고 선을 

decimalsSpinBox 에로 끌고가서 놓는다. 

- 누름단추의 추가 

• Toolbox 안에서 Common Widgets 단추를 찰칵한다. 

• Pushbutton 단추를 두번 련속 찰칵하고 대화칸의 왼쪽아래 모서리의 Decimals 
표식자아래를 찰칵한다. 

• 새 누름단추의 오른쪽을 두번 더 찰칵하여 대화칸바닥의 한 행에 누름단추들이 
수평으로 놓이게 한다. 

• Pointer 도구띠 단추를 찰칵하여 누름단추를 해계 한다. 

Property Editor 창문에서 각 누름단추에 대하여 몇가지 속성을 변경한다. 

• 제일 왼쪽에 있는 누름단추를 찰칵하고 이름을 clearPushButton 로，본문을 
&Clear 로 변경한다. 

•중간의 누름단추를 찰칵하고 이름을 calculatePushButton 로， 본문을 
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Calculate 로, 기정속성을 True 로 변경한다. 

• 제일 오른쪽 누름단추를 찰칵하고 이름을 quitPushButton 로，본문을 & Quit 로 
변경 한다. 



그림 1-7. 대화칸에 누름단추의 추가 

- 수축자의 추가 

대화칸에서 수축자 ( spacer ) 들을 추가하여 부품들사이의 여유공간을 조절함으로써 
그것 들을 보기 좋게 배 치 할수 있 다. 

• Toolbox 에서 Common Widgets 단추를 찰칵한다. 

• Spacer 단추를 찰칵하고 Decimal 표식자의 오른쪽을 누르고 스핀칸쪽으로 오른쪽 
으로 끌고가서 놓는다. 수평수축자가 표시된다. 

• Spacer 단추를 다시 찰칵하고 Calculate 누름단추의 오른쪽을 누르고 Quit 누름단 
추쪽으로 오른쪽으로 끌고가서 놓는다. 

• Spacer 단추를 찰칵하고 스핀칸 바로 아래를 누르고 단추들의 방향으로 수직으로 
끌고가서 마우스를 놓는다. 수직수축자가 나타난다. 
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그림 1-8. 대화칸에 수축자의 추가 
File | Save 를 눌러서 우에서 설정한 내용들을 보존한다. 

- 창문부품의 편집 

이제는 창문부품들을 편집하여 변환에 필요한 값들을 포함하게 한다. 
fromComboBox : 

• fromComboBox 를 오른쪽 단추찰칵하여 열리는 문맥차림표로부터 Edit 를 찰칵한다. 

• New Item 을 찰칵한 다음 New Item 본문을 삭제 하고 Kilometers 로 바꾼다. 

• New Item 을 찰칵하고 본문을 Meters 로 변경 한다. 

• New Item 을 찰칵하고 본문을 Centimeters 로 변경 한다. 

• New Item 을 찰칵하고 본문을 Millimeters 로 변경 한다. 

• OK 를 찰칵하여 Edit Lis 比) ox 대화칸을 닫는다. 



그림 1-9. 창문부품의 편집 
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toComboBox ： 

• toComboBox 를 오른쪽 단추로 찰칵하면 열리는 문맥차림표에서 Edit 를 찰칵한다. 

• New Item 본문을 삭제하고 Miles 라고 입력 한다. 

• New Item 을 찰칵하고 본문을 Yards 로 변경 한다. 

• New Item 을 찰칵하고 본문을 Feet 로 변경 한다. 

• New Item 을 찰칵하고 본문을 Inches 로 변경 한다. 

• OK 를 찰칵하여 Edit Lis 比 > ox 대화칸을 닫는다. 

3) 대화칸의 배치 

우선 본문표식자들과 그에 대응하는 창문부품들을 배치하고 마지막에 누름단추를 
배 치 한다. 

• decimalsSpinBox 를 선택하고 그 다음에 있는 수축자우에서 Shift 를 누르면서 
마우스단추를 찰칵한다. 

• Lay Out Horizontally ( Ctrl + H ) 도구띠 단추를 찰칵한다. 

•폼을 찰칵하여 이미 선택상태를 해제한다. 

• Decimals 본문표식자의 왼쪽에 있는 픔부분을 찰칵하고 decimals 수축자는 포함되 
지만 다른 수축자들과 누름단추들은 피하면서 모든 표식자과 창문부품이 닿도록 선택창 
을 끌고간다. 마우스를 놓고 요구되는 창문부품들이 선택되였다는것을 알린다. 

•Lay Out in a Grid ( Ctrl + G ) 도구띠 단추를 찰칵한다. 
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그림 1-10. 살창배치 

• Object Explorer 창문 (Objects 타브) 에서 Clear 누름단추를 찰칵하고 그다음 Shift 를 누 
르면서 Calculate 누름단추, Quit 누름단추，누름단추들사이의 수축자를 마우스로 선택한다. 

• Lay Out Horizontally 도구띠 단추를 찰칵한다. 
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그림 1-11. 누름단추들의 수평배치 

• 폼을 눌러서 모든 창문부품선택과 배치를 해제하고 Lay Out Vertically ( Ctrl + L ) 
도구띠단추를 찰칵한다. 

• 끝으로 폼을 선택 하고 Adjust Size ( Ctrl + J ) 도구띠 단추를 찰칵한다. 



그림 14合. 수직배치 

FilelSave 를 눌러서 대화칸을 보관한다. 

- 타브순서 

대화칸의 타브순서가 정확히 설정되였는가 검사한다. 

• Tab Order 도구띠단추를 찰칵한다. 수자가 표시 된 푸른색 의 원 이 초점 을 받아들 
이는 매개 창문부품의 옆에 표시된다. 

• 초점을 받아들이는 순서로 매개 창문부품들을 찰칵한다. 

• Esc 건을 눌러서 타브순서방식에서 탈피한다. 
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그림 1-13. 타브순서 

4) 대화칸의 미리보기 

대화칸을 미 리 보려면 Ctrl+T 를 누르거 나 도구띠에서 Preview | Preview Form 을 
찰칵한다. 대화칸의 모서리를 끌기하여 크기를 조절한다. 창문부품들은 항상 대화칸의 
크기에서 문제가 없도록 비례에 맞게 배치된다. Tab 건을 눌러서 창문부품들의 타브순서 
를 검사한다. 

5) 창문부품의 련결 

3개의 단추 즉 Clear 단추， Calculate 단추， Quit 단추를 련결해야 한다. 또한 일부 
다른 창문부품들도 련결해 야 한다. 보통 View and Edit Connections 대화칸을 사용하 
여 모든 련결을 수행한다. 

이제 clearButton 을 련결한다. 

• Edit | Connections 을 찰칵하여 View and Edit Connections 대화칸을 펼친다. 

• New 를 찰칵하고 새로운 련결을 입 력한다. 

• 첫 련결에 대하여 Sender 로서 clearPushButton , Signal 로서 clicked 0, 
Receiver 로서 numberLineEdit , Slot 로서 clearO 를 선택한다. 

• 다시 New 를 찰칵한다. 

• Sender 로서 clearPushButton , Signal 로서 clicked (), Receiver 로서 

resultLineEdit , Slot 로서 clearO 를 선택한다. 

• 다시 New 를 찰칵한다. 

• Sender 로서 clearPushButton , Signal 로서 clicked (), Receiver 로서 

numberLineEdit , Slot 로서 setfocusO 를 선택한다. 
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그림 1-14. clearButton 의 련결 
또한 중지단추를 픔과 련결한다. 

• New 를 찰칵한다. 

• Sender 로서 quitPushButton , Signal 로서 clicked (), Receiver 로서 

ConversionForm , Slot 로서 closeO 를 선택한다. 

Calculate 단추와 다른 창문부품들을 련결하려고 하지만 사용하려는 처 리부는 복합칸에 
렬거되지 않는다. 새로운 처리부를 만들고 목록에서 그것을 선택하여 련결을 완료한다. 

• New 를 찰칵한다. 

• Sender 로서 calculatePushButton , Signal 로서 clicked 0, Receiver 로서 
ConversionForm 을 선택한다. 

• Edit Slots 를 찰칵하여 Edit Functions 대화칸을 연다. 

• New Function 를 찰칵한다. 

• Function name 에 새 함수이름 convert 0를 입 력 한다. 

• ◦災를 찰칵한다. 

Slot 복합칸에서 converter 선택하여 련결을 완성한다. 
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그림 1-15. 함수의 편집 

이제는 마지막으로 여러개의 창문부품들을 련결한다. 

• New 를 찰칵한다. 

• Sender 로서 decimalsSpinBox , Signal 로서 valueChanged ( int ) , Receiver 로 
서 ConversionForm , Slot 로서 convertO # 선택한다. 

• New 를 찰칵한다. 

• Sender 로서 fromComboBox , Signal 로서 activated ( int ), Receiver 로서 
Con versionForm , Slot 로서 convertO 를 선택한다. 

• New 를 찰칵한다. 

• Sender 로서 toComboBox , Signal 로서 activated ( int ), Receiver 로서 

Con versionForm , Slot 로서 convertO 를 선택한다. 

• New 를 찰칵한다. 

• Sender 로서 calculatePushButton , Signal 로서 clicked ( int ), Receiver 로서 
numberLineEdit , Slot 로서 setFocusO 를 선택한다. 
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그림 1-16. 창문부품들과 ConversionFomi 의 convert 와의 련결 

• OK 단추를 찰칵하여 View and Edit Connections 대화칸을 닫는다. 

• Save 를 눌러서 프로젝트를 보관한다. 

3. 대화칸코드작성 

Project Overview 창문에서 conversionform . ui.h 를 눌러서 코드편집기를 연 
다. convertO 함수와 initO 함수를 실현한다. 
void ConversionForm: : convert() 

{ 

enum MetricUnits { 

Kilometers, 

Meters, 

Centimeters, 

Millimeters 

}； 

enum OldUnits { 

Miles, 

Yards, 

Feet, 

Inches 
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// 입력을 엄는다 

double input = numberLineEdit->text().toDouble(); 
double scaledlnput = input; 


// 내부적으로 입력을 mm 로 변환한다 
switch ( fromComboBox->currentItem() ) { 
case Kilometers: 

scaledlnput *= 1000000; 
break; 

case Meters: 

scaledlnput *= 1000; 
break; 

case Centimeters: 
scaledlnput *= 10; 
break; 

} 

// in 으로 변환한다 

double result = scaledlnput * 0.0393701; 


switch ( toComboBox->currentItem() ) { 
case Miles: 
result /= 63360; 
break; 
case Yards: 
result /= 36; 
break; 
case Feet: 
result /= 12; 
break; 

} 
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// 결과를 설정한다 

int decimals = decimalsSpinBox->value() ; 

resultLineEdit->setText( QString::number( result, 'f, decimals ) ); 
numberLineEdit->setText( QString: :number( input, *f, decimals ) ); 

} 

우선 입 력과 출력단위를 위한 렬거형을 정의 한다. 그다음 numberLineEdit 로부터 
입력을 엄는다. 입력을 가장 정확한 메터계 단위 인 미 리메터로 변환한다. 그다음 가장 정 
확한 출력단위 인 인치 로 변환한다. 그다음 선택된 출력단위 로 그것을 비 례 화한다. 끝으 
로 결과를 resultLineEdit 에 넣는다. 

다음으로 대화칸이 창조될 때 호출되는 initO 함수를 실현한다. 
void ConversionForm: : init() 

{ 

numberLineEdit->setYalidator( new QDoubleValidator( numberLineEdit) ); 

numberLineEdit->setText( "10" ); 

convert(); 

numberLineEdit->selectAll(); 

} 

이 함수에서는 numberLineEdit 에 대하여 유효성확인기를 설정하여 사용자가 수만 
입력할수 있게 한다. 또한 이것을 수행하기 위하여 픔의 꼭대기, 바로 initO 우에 
#include < qvalidator . h 〉 를 추가해 야 한다. 끝으로 초기 입 력을 설정한다. 

응용프로그람을 실행할 준비가 거의 되였다. 응용프로그람을 를파일하기전에 
main , cpp 파일이 요구된다. 

File | New 를 눌러서 New File 대화칸을 연다. 

C++Main File ( main , cpp ) 을 선택하고 OK 를 찰칵한다. 

Configure Main-File 대화칸와 련관된 기정선택을 받아들인다. 

Save 를 눌러서 프로젝트를 보관한다. 

- 응용프로그람의 롬파일과 실행 

기동하거 나 콘솔로 절환하고 프로젝트를 보관한 등록부로 넘 어 간다. 

qmake -o Makefile metric , pro 라고 입 력 하여 프로젝 트파일 ( metric , pro ) 에 대 하여 
qmake 를 실행한다. 

make 를 실행한다. (혹은 체계에 따라서 nmake 를 실행한다.) 

프로젝트를 콤파일한 다음 응용프로그람을 실행 한다. 

이 응용프로그람은 Qt Designer 에 대 한 간단한 소개와 폼에 창문부품의 추가，창문부 
품속성의 설정，신호-처리부련결만들기，전용코드의 배치와 추가에 대한 소개를 주었다. 
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제 2 절. 기본창문응용프로그람의 작성 

2절과 3절에서는 colortool 이라고 부르는 작으면서도 완전한 Qt 응용프로그람을 작성 
한다. colortool 응용프로그람은 이름을 색과 결합하는데 사용된다. 이것은 사용자와의 대 
화칸을 편리하게 하는 전용대화칸을 가지는 표준기본창문응용프로그람을 구성한다. 이 절 
에서는 기본창문을 학습하고 다음 절에서는 응용프로그람을 완성하는 대화칸을 학습한다. 

1. Color To 이응용프로그람 



그림 1-17. 색도구의 그림기호보기 

colortool 응용프로그람은 다중가동환경 응용프로그람으로서 사용자가 색 목록을 생 성 하고 
편집하고 보관할수 있게 한다. 매개 색은 사용자정의이름과 RGB (적，록, 청)값을 가전다. 

이 응용프로그람은 사용자에게 일련의 색과 이름을 가지는 보기를 제시한다. 
QWidgetStack 를 사용하여 사용자가 절환할수 있는 2개의 보기를 제공한다. 표형식보 
기는 매개의 색을 작은 장방형과 이름, 16진값으로 보여준다. 또한 지적자의 선택을 제 
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공하여 색이 216표준웨브색인가 아닌가를 보여주게 한다. 그림기호보기는 매개 색을 원 
형 색 견본과 그 아래 에 이 름을 표시한다. 

응용프로그람은 rgb . txt 파일에 X 체계에서 사용하는 형식으로 읽고 쓴다. 이것은 사용 
자가 자체의 색파일들을 생성하고 rgb . txt 형식파일들을 적재，편집，보관할수 있게 한다. 

간단한 탐색선택을 제공하여 사용자가 색을 고속으로 찾을수 있다. 이것은 수백, 수천 
개의 색을 표시할 때 특별히 쓸모있다. 탐색을 이행허용대화칸로 제공함으로써 사용자는 람 
색과정에 기본폼과 계속 교제할수 있다. 또한 사용자가 색을 추가, 삭제하고 사용자선택을 
설정할수 있게 한다. 그 편리를 도모하기 위하여 이행금지대화칸을 생성해야 한다. 

끝으로 응용프로그람이 기동할 때 사용자선택을 적재 하고 완료할 때 사용자선택을 보관하 
도록 담보해야 한다. 또한 이 선택에는 보기와 기본창문의 크기와 위치를 포함함으로써 응용 
프로그람은 항상 사용자가 마지막에 리용하였던 크기, 위치, 보기로 기동할수 있다. 



그림 1-18. 색도구의 표형식보기 
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2. Qt Designer 의 기동과 완료 

Windows 하에서 Qt Designer 를 기동하려면 Start 단추를 찰칵하고 Programs | Qt 
X . x . x | Designer ( X . 지표는 Qt 판번호，례하면 3.1.0) 를 선택한다. Unix 나 Linux 조작 
체계를 실행하고있다면 Qt Designer 그림기호를 두번 련속 누르거나 xterm 에서 
designer &라고 입 력 한다. 

Qt Designer 가 기동할 때 New / Open 대화칸이 표시된다. Qt Designer 를 다음에 
열 때 이 대화칸의 표시를 요구하지 않는다면 " Don’t show this dialog in the future ” 
검사칸을 설정한다. 

이 실례에서 Cancel 을 찰칵하여 대화칸을 무시한다. 



그림 l -19. NeWOpen 대화칸 

Qt Designer 의 사용이 끝나면 File | Exit 를 찰칵한다. 변경을 보관하지 않았으면 
그것을 보관하겠는가를 묻는다. F 1 를 누르거나 Help 차림표로부터 방조를 엄을수 있다 
이 장을 정확히 리해 하려면 Qt Designer 를 기동하고 colortool 응용프로그람을 작성 
해보아야 한다. 대부분의 작업은 Qt Designer 의 차림표，대화칸와 편집기의 리용을 요구 
한다. 작업 할 때 Qt Designer 의 코드편집기를 리용하여 코드를 직접 입 력 하여 야 한다. 
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기정으로 Qt Designer 를 기동할 때 차림표띠와 각종 도구띠를 볼수 있다. 왼쪽에 
있는것이 창문부품 Toolbox 이다. 도구칸의 단추들을 선택하여 특별한 도구일식을 표시 
한다. 오른쪽에 3개의 창문이 있다. 즉 첫째는 Project Overview 창문，둘째는 Object 
Explorer 창문，그리고 셋째는 Properties Editor/Signal Handlers 창문이다. Project 
Overview 창문은 프로젝트와 련관된 파일과 화상들을 표시한다. 임의의 픔 (.ui 파일)을 
열거나 그와 련결된 코드 (.ui.h 파일)를 열려면 간단히 그것을 한번 찰칵한다. Object 
Explorer 창문은 현재 폼의 창문부품과 성원들을 렬거한다. Properties Editor/Signal 
Handlers 창문은 폼과 창문부품의 속성을 보고 변경하는데 사용된다. 실례응용프로그람 
을 작성할 때 Qt Designer 의 창문，대 화칸, 차림 표선택，도구들의 사용법 을 설명 한다. 

3. 프로젝트 작성 

colortool 응용프로그람은 표준 C++ 응용프로그람으로 만들려고 하므로 C++ 프로젝트 
를 창조하고 이 프로젝트에 파일들과 코드를 추가해야 한다. 

- 프로젝트의 작성 

새로운 응용프로그람을 작성할 때는 항상 프로젝트를 창조하고 개별적인 .ui 파일이 
아니라 프로젝트를 열것을 권고한다. 프로젝트리용은 프로젝트용으로 창조하는 모든 폼 
들을 파일열기대화칸을 통하여 개별적으로 적재하는것보다 마우스를 한번 찰칵하여 수행 
할수 있다는 우점 이 있다. 프로젝트파일사용의 다른 우점은 하나의 파일에 자기 화상을 
모두 보관하여 화상들이 나타나는 매개 폼에 그것들을 중복하여 보관하지 않게 하는데 
있다 (4 절 1. 프로젝트관리). 

프로젝 트파일 들은 .pro 뒤 붙이 를 사용하며 qmake 도구에 의 하여 관련목표가동환경 
을 위한 makefiles 을 작성 하는데 사용된다. 

다음과 같이 새 프로젝트를 작성한다. 

File | New 를 선택 하여 New File 대 화칸을 연다. 

C++ Project 를 선택하여 C++ 프로젝트를 작성한 다음 OK 를 찰칵하여 Project 
Settings 대화칸을 연다. 

Project File 행편집칸의 오른쪽에 있는 생 략기호단추를 찰칵하여 Save As 대화칸을 
연다. 이 대화칸을 사용하여 새 프로젝트를 생성하려는 곳으로 가서 Create New 
Folder 도구띠 단추를 사용하여 실제 로 새 폴더 (실례 로 colortool) 를 만든다. 

파일이름을 colortool.pro 라고 입력한 다음 Save 를 찰칵한다. 그러면 프로젝트이 
름이 colortool 로 된다. OK 를 찰칵하여 Project Settings 대화칸을 닫는다. 
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|.¥ 후 Project Settings 1 

Settings | C++ | 

Project File: |er/examples/colortool/colortool. pro 

Language 

Database File : 「 




Help | | OK I Cancel 

~ 스 

그림 1-20. Project Settings 대화칸 
File ᅵ Save 를 눌러서 프로젝트를 보관한다. 



그림 1-21. New File 대 화칸 

New File 대화칸은 Qt Designer 프로젝트에서 사용할수 있는 모든 파일들을 창조하 
는데 사용된다. 여기에는 C ++ 원천파일，자동생성된 main . cpp 파일，미리 정의된 형판에 
기초하는 각종 폼들이 포함된다. (자체의 형판들도 만들수 있다.) 

colortool 응용프로그람에서는 기본창문종으로 기동하려 고 한다. 이 폼을 창조할 때 
Qt Designer 는 차림표와 도구띠선택을 자동적으로 생성하고 련관된 신호/처리부를 자 
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동생성할수 있는 위 자드를 제 공한다. 모든 차림 표선택 이 나 도구띠단추에 대 하여 Qt 
Designer 는 하나의 QAction 을 생성 한다. 

- 작용과 작용그룹 

작용 (action) 은 사용자대면부를 통하여 사용자가 받아들이는 조작이다. 실례로 파 
일보존이 나 본문서체를 강조체로 변경 . 

흔히 사용자가 각종 수단을 사용하여 작용을 처리할수 있게 하려고 한다. 실례로 
파일을 보관하기 위 하여 사용자가 Ctrl+S 건을 누르게 하거 나 Save 도구 띠단추를 누르게 
하거나 File | Save 차림표선택을 누르게 할수 있다. 작용호출수단이 다르다 할지라도 그 
기초조작은 갈으며 그 조작을 수행하는 코드를 반복하여 쓰러고 하지 않는다. Qt 에서는 
작용이 호출될 때 적 당한 함수를 호출하는 QAction 객체를 창조할수 있다. 작용에 지름 
건(례하면 Ctrl+S) 을 할당할수 있다. 또한 차림표와 도구 띠에 작용을 추가할수 있다. 

작용이 on 八) ff 상태를 가지면 례하면 강조체가 선택 혹은 해제이면 사용자가 상태를 
변경 할 때(가령 도구띠단추를 찰칵하여) 그 작용과 련관된 모든것(례 하면 차림 표항목과 
도구띠단추)의 상태는 갱신된다. 

일부 작용은 라지오단추처럼 함께 조작하여야 한다. 실례로 왼쪽맞추기，중심맞추 
기, 오른쪽맞추기작용들이 있다면 임의의 시각에 오직 하나만 on 으로 되여야 한다. 작 
용그롭 (QActionGroup 객체)은 일련의 작용들을 하나로 묶는데 사용된다. 작용그룹의 
배타적인 속성이 TRUE 이면 그룹안의 단 하나의 작용이 임의의 시각에 on 일수 있다. 
사용자가 배 타적 속성 이 참인 작용그룹의 한 작용의 상태 를 변경하면 작용그룹안의 그 작 
용과 련관된 모든것，실례 로 차림 표항목과 도구띠단추들이 갱 신된다. 

Qt Designer 는 시각적으로 작용과 작용그룹을 만들고 그것들에 지름건을 할당하고 
차림 표항목들이나 도구띠단추들과 련결 할수 있다. 

4. 기본창문의 작성 

Main Window Wizard 를 사용하여 기 본창문을 만든다. 위 자드는 사용자가 작용은 
물론 작용을 호출할수 있는 차림표띠와 도구 띠를 만들수 있게 한다. 또한 자체의 작용, 
차림 표와 도구 띠단추들을 만들수 있고 기 본창문부품을 기 본창문에 추가할수 있 다. 

File|New 를 눌러서 New File 대화칸을 열고 Main Window 를 눌러서 기본창문폼 
을 생성한 다음 OK 를 찰칵한다. 새로운 QMainWindow 폼이 만들어지고 Main 
Window Wizard 가 올리펼쳐 진다. 

1) Main Window 위자드의 사용 

처음에 Choose available menus and toolbars 폐지가 나타난다. 이것은 3 가지의 
기정 작용 즉 File 작용， Edit 작용 그리고 Help 작용을 제시 한다. 각 종류에 대하여 Qt 
Designer 가 차림 표항목，도구띠단추，관련된 작용을 위 한 신호/처 리부련결을 가지 도록 
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선택할수 있다. 항상 작용，차림표띠, 도구띠단추를 추가 혹은 삭제하거나 후에 련결을 
추가삭제할수 있다. 

여기서는 File 과 Edit 의 기정작용을 받아들인다. 즉 차림표항목들, 도구띠단추들 그 
리고 생성된 관련련결들을 가진다. 사실 후에 Edit 작용을 많이 변경하지만 여전히 지금은 
그것들을 생성하는것이 편리하다. 여기서는 Help 작용을 가지지 않으므로 Help 작용의 도 
구띠검사칸을 비설정상태로 한다. Next 를 찰칵하여 위자드의 다음 패지로 넘어간다. 



그림 1-22. Main Window Wizard - 차림 표와 도구띠 의 선 택 
Setup Toolbar 위 자드페 지 는 기 정 작용으로부터 도구띠 의 작용들을 선택 하는데 사용 
된다. Category 복합칸은 작용들의 종류를 선택하는데 사용된다. Actions 목록칸은 현재 
종류에서 사용할수 있는 작용들을 표시한다. Toolbar 목록칸은 만들려는 도구띠단추들을 
표시한다. 하늘색의 왼쪽, 오른쪽 화살단추들은 Toolbar 목록칸의 안이나 밖으로 작용 
들을 이동하는데 사용된다. 청색의 올리，내리화살단추들은 Toolbar 목록칸안에서 작용 
들을 우로 혹은 아래로 옮기는데 사용된다. Actions 목록칸안의 <Separator> 항목은 필 
요할 때 Toolbar 목록칸까지 이동할수 있으며 완료된 도구띠에 구분선이 보이게 한다. 

Toolbar 목록칸에 New 와 Open, Save 작용들을 복사한다. Tmlbar 목록칸에 
〈 Separator 〉 를 하나 복사한다. Category 를 Edit 로 바꾸고 Toolbar 목록칸에 Cut 와 
Copy, Find 작용들을 복사한다. Next 를 누른 다음 Finish 를 찰칵한다. 

File | Save 를 찰칵하고 풍을 mmnform.ui 로 보관한다. 
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그림 1-23. Main Window Wizard - 도구띠 설 정 

폼을 미리보기 ( Ctrl + T ) 하고 File 과 Edit 차림표들을 사용할수 있으며 도구띠를 자 
기의 독립적인 창문으로 끌고가거나 그것을 창문의 좌, 우，아래, 우로 류동할수 있다. 
차림표와 도구띠는 아직 동작하지 않지만 점차 이것을 수정한다. 폼의 Close 칸을 눌러 
서 (혹은 가동환경 에 고유한 조작을 하여 ) 미 리 보기방식 을 완료한다. 



그림 1-24. 폼의 미리보기 
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이제는 좀을 만들었으므로 그 속성을 일부 
변경하여 야 한다. 

- Property Editor 의 사용 

Property Editor 는 2개 렬을 가지는데 
Property 렬은 속성이름을 렬거하고 Value 렬은 
속성값들을 렬거한다. 일부 속성이름의 왼쪽에는 
네모칸안에 +가 들어있는 기호가 있는데 이것은 
속성이름이 관련된 속성들의 모임에 대한 이름이 
라는것을 가리킨다. 좀이나 창문부품을 눌러서 
Property Editor 에 그 좀이나 창문부품의 속성들 
이 표시되게 한다. 

실례로 sizePolicy 속성의 +기호를 선택하면 
sizePolicy 아래에 4개의 속성 즉 hSizeType , 
vSizeType , horizontal Stretch 과 

vertical Stretch 가 나타나는것을 보게 된다. 이 속 
성들은 다른 속성들과 같은 방법 으로 편집된다. 

창문부품들의 전체모임에 대하여 갈은 속성 
을 변경하려고 한다면(실례로 그것들에게 모두 
공통유표, 도구암시, 색 등을 주려고 한다면) 

그 창문부품들중 하나를 선택하고 Shift 와 함 
께 마우스를 찰칵하여 다른것들도 모두 선택한 
다. (혹은 Object Explorer 에서 첫 창문부품의 
이름을 찰칵하고 Shift 와 함께 마우스를 찰칵하 
여 Object Explorer 의 다른것들도 모두 선택한 
다. 이 수법은 많은 겹쌓인 창문부품들과 배치 
를 가지는 픔들에 특별히 쓸모있다.) 그것들이 
공통적으로 가지는 속성들은 속성편집기에 표시 
되고 하나의 속성에 대한 변경은 선택된 모든 
창문부품들을 그와 같은 속성으로 만든다. 

일부 속성들은 단순값을 가전다. 실례로 
name 속성은 본문값을 가지며 wid 比 i 속성 

( minimumSize 내에서)은 수값을 가진다. 본문값을 변경하려면 현존본문을 선택하고 새 
본문을 입력한다. 수값을 변경하려면 그 값을 선택하고 새 수값을 입력하거나 스핀단추 
에 의하여 현존값을 요구하는 값에 이를 때까지 증가감소시킨다. 일부 속성은 고정된 값 



Properties I Signal Handlers J 

Property 

Value 

- 

E name 

viainForm x 


enabled 

True 


0 sizePolicy 

Preferred/... 


田 minimumSize 

[ 8, 126 ] 


囚 maximumSize 

[ 32767, 3". 


E sizelncrement 

[0,0] 


田 baseSize 

[ 0 , 0 ] 


E paletteForegr". 



0 paletteBackgr... 



paletteBackgr... 



palette 



backgroundOri... 

WidgetOrigin 


田 font 

Verdana [... 


cursor 

Arrow 


0 caption 

Color Tool 


icon 



I 王！ iconText 



mouseTracking 

False 


focusPolicy 

NoFocus 


acceptDrops 

False 


rightJustification 

False 


usesBigPixmaps 

False 


usesTextLabel 

False 


dockWindows... 

True 


opaqueMoving 

False 


田 toolTip 



囚 whatsThis 


: J 


그 림 1 -25. Property Editor 
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목록을 가진다. 실례로 mouseTracking 속성은 론리값이며 True 혹은 False 값을 가질 
수 있 다. 또한 유표속성은 고정 값목록을 가진다. cursor 속성과 mouseTracking 속성을 
누르면 내리펼침복합칸에 값이 표시된다. 내리화살표를 눌러서 어떤 값이 유효한가를 볼 
수 있다. 일부 속성들은 값 혹은 특수값들의 복잡한 모임을 가전다. 실례로 font 속성과 
iconSet 속성을 들수 있다. font 속성을 선택하면 생략기호단추 (...) 가 나타난다. 이 단 
추를 누르면 서체설정을 변경하는데 사용할수 있는 Select Font 대화칸이 펼쳐진다. 다 
른 속성들도 생략단추를 가지며 속성이 가질수 있는 설정내용에 따라 각이한 대화칸들이 
펼쳐진다. 실례로 text 속성으로 입력할 본문이 많다면 생략단추를 찰칵하여 Multi-line 
Edit 대화칸을 펼칠수 있다. 

변경된 속성이 름은 강조체 로 표시된다. 속성 을 변경 하였는데 기정 값을 되살리 려 고 
하는 경우 그 속성의 값을 선택하고 적색 X 단추를 찰칵하여 값을 되살린다. 일부 속성 
은 초기값 실례로 Tex 犯 ditl 을 가지지만 기정값은 없다. initial 값을 가지지만 기정값이 
없는 속성 을 되살리 면 (적색표를 눌러서 ) 그 값은 속성(례 하면 이 름) 이 비는것 이 허 용되 
지 않으면 빈칸으로 된다. 

속성편집기는 Undo 와 Redo ( Ctrl + Z 와 Ctrl + Y , 또는 Edit 차림표에서 사용가능)를 
완전히 유지한다. 

2) 폼의 속성과 작용의 설정 

좀을 선택하여 모든 속성이 Property Editor 에 나타나게 한다. 좀의 name 을 
MainForm 로，그 cap 仕 on 을 "Color Tml " 로 변경한다. 

이제는 기본창문위자드를 생성하였으나 응용프로그람과 련관되지 않은 작용들을 삭 
제 해 야 한다. 

Object Explorer 의 Members 타브를 선택 한다. filePrintO 처 리부를 오른쪽 단추로 
찰칵한 다음 튀 여 나오기차림 표로부터 Delete 를 찰칵한다. 같은 방법 으로 editUndoO 와 
editRedoO , editPasteO 처리 부들을 삭제 한다. 후에 응용프로그람에 기능을 추가할 때 
새 처리부를 생성하는 방법을 보게 된다. 

또한 Action Editor 창문에서 이 작용들을 삭제해 야 한다. filePrintAc 吐 on 작용을 
오른쪽 단추로 찰칵하고 튀 여 나오기 차림 표에 서 Delete Action 을 찰칵한다. 같은 방법 으 
로 editUndoAction 과 editRedoAction , editPasteAction 작용을 삭제한다. 

끝으로 폼의 차림 표에 서 삭제 한 작용들을 구분하고있 던 분리 선들을 삭제한다 

Action Editor 창문은 류동가능하므로 그것을 마음대로 류동하지 않게 하려면 Qt 
Designer 의 류동령역 (기본창문의 상，하，좌，우)중 임의의곳으로 끌고가면 된다. 

폼의 File 차림 표를 선택 한다. (지 금 Qt Designer 의 File 차림 표가 아니 라 새 로 생성 
한 픔의 File 차림표를 선택하고있다.) Exit 차림표선택에 2개의 분리선이 있다. 
( File | Print 선택을 삭제하기전에 사이에 분리선이 있었다.) 분리선들중 하나를 선택하 
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고 Delete 건을 누른다. 실수하여 우연히 차림표선택을 삭제할수 있다. 잘못 삭제하였다 
면 EditlUndo 하여 취소한다. 폼의 Edit 차림표는 제 일 웃끝에 여분의 분리선을 가지고 
있다. (거기에 취소와 재시행선택 이 있었다.) 갈은 방법으로 이 분리선을 삭제한다. 차 
림표선택을 잘못 삭제하였다면 Ctrl + Z 를 눌러서 취소한다. 

File | Save 를 눌러서 폼을 보관한다. 

이제는 Preview | Preview Form (또는 Ctrl + T ) 을 눌러서 폼을 미리볼수 있다. 

- Object Explorer 

Window |Views | Object Explorer 를 선택 하여 Object Explorer 창문을 펼친 다. 
Object Explorer 에는 2 개의 타브가 있는데 Objects 타브는 객체의 계층을 보여주고 
Members 타브는 폼에 추가한 성원들을 보여준다. Objects 타브안의 창문부품이름을 눌러 
서 창문부품을 선택하고 Property Editor 에 그 속성들을 표시한다. 많은 창문부품을 
가지거나 배치를 요구하는 폼들에 특히 쓸모있는 창문부품들을 Object Explorer 에서 
간단히 보고 선택할수 있다. 여 러 창문부품은 처음것을 누른 다음 Shift 를 누르면서 다 
른것들을 눌러서 선택할수 있다. 



Objects I Members | 


Name 

Class 

□ MainForm 

QMainWindow 


3 jmenubar 

QMenuBar 


8 jfileMenu 

QPopupMenu 



「、ᅵ fileNewAction 

QAction 



^ 용 fileOpenAction 

QAction 



OfileSaveAction 

QAction 



fileSaveAsAction 

QAction 



fileExitAction 

QAction 


$ |editMenu 

QPopupMenu 



^jeditAddAction 

QAction 



^ editCutAction 

QAction 



^jeditCopyAction 

QAction 



Q N editFindAction 

QAction 



liTloptionsAction 

QAction 


$ jPopupMenu 

QPopupMenu 


i i h 

^^viewT ableAction 

QAction 


! I H 

p^viewIconsAction 

QAction 


그림 1-26. Object Explorer 
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Qt Designer 의 초판에서 폼에 코드를 제 공하려 고 한다면 폼의 파생 콜라스를 만들고 파 
생클라스에 코드를 추가한다. 이 판은 파생클라스작성수법을 충분히 지원하지만 폼에 코드 
를 직접 삽입하는 다른 수법도 제공한다. Qt Designer 에서 코드쓰기는 파생클라스작성과 같 
이 잘되지 않는다. 실례로 폼의 구성자나 해체자에 대한 직접호출을 얻을수 없다. 구성자에 
의해 실행되여야 하는 코드가 요구된다면 voidinitO 라는 처리부를 만든다. 그것이 이미 존 
재하면 구성자로부터 그것을 호출한다. 마찬가지로 해체자전에 실행하려는 코드가 요구되면 
void destroy 0라는 처리부를 생성한다. 또한 자체의 클라스변수들을 추가하여 생성된 구 
성자코드에 삽입할수 있으며 필요한 앞방향선언과 머려부들을 추가할수 있다. 변수나 선언 
을 추가하려면 적당한 항목 례 하면 Class Variables 를 오른쪽 단추로 찰칵하고 New 를 누 
른 다음 본문 례하면 QString m _ filename 을 입 력 한다. 1개 이상의 항목이 존재 하면 오른쪽 
단추로 찰칵하여 New 와 Edit , Delete 선택을 가지는 차림표를 펼친다. 여러 항목 례를 들 
면 여러개의 머리부파일이나 여러개의 자료성원을 입력하려면 관련구간에서 오른쪽 단추를 
찰칵하고 Ed 比를 눌러서 Edit 대화칸을 호출하는것이 제일 간단하다. 코드를 편집하려면 함 
수이름을 눌러서 코드편집기를 펼친다. 코드편집과 처리부생성은 후에 학습한다. 

폼의 파생콜라스를 만들려면 자체의 . cpp 파일을 만들고 거기에 필요한 구성자，해 
체자，함수들, 처리부들, 선언과 변수들을 넣는다. 

3) 전용작용의 추가 

응용프로그람에 고유한 작용을 사용자에게 제공하려고 할수 있다. 2개의 보기들사이 
를 절환하고 사용자가 색을 추가하고 자기가 좋아하는 선택을 추가하게 하려고 한다. 보 
기선택용의 새 차림표를 생성하고 도구띠 에 분리선을 추가하여 그 방법을 준비한다. 

차림표띠에서 new menu 를 찰칵하고 본문에 & View 라고 입력한다. &는 다음 문자에 밑선 
을 붙이여 Alt 지름건을 만든다. (다시말하여 이 경우에 Alt + V 는 View 차림표를 펼친다.) 


File Edit Help 


그림 1-27. 차림표띠 

- 복사지름건 

많은 창문부품을 포함하는 대화칸을 가지는 응용프로그람에서 지름건들이 우연히 
중복될수 있다. Qt Designer 는 같은 지 름건들을 가지 는 2개 이 상의 창문부품들이 강조표 
시되는 경우를 쉽게 검사하게 하는 Edit | Check Accelerators ( Alt + R ) 를 제공한다. 

Help 차림표의 왼쪽으로 View 차림표를 끌고가서 그것을 놓는다. (수직재색선은 그 
위치를 가리킨다.) 


File 면바述 elp new menu new separator 

그림 1-28. View 차림 표항목의 끌기 
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현존도구띠의 끝에 분리선을 넣고 분리선뒤에 View 선택을 추가할 대신에 View 차 
림 표항목용의 새 로운 도구띠 를 생 성 할수 있 다. 제 일 오른쪽 도구띠단추 ( Find ) 를 오른폭 
단추로 찰칵하고 Insert Separator 를 찰칵한다. 혹은 완전히 새 로운 도구띠 를 생 성할수 
있 다. 


1 D 유 H 1 X ■ 必 、 1 Delete Item 





Insert Separator 

Delete Toolbar 


그림 1-29. 도구띠차림표에 분리선의 삽입 


- 도구띠의 작성과 이식 

새 도구띠는 현존 도구띠의 오른쪽을 찰칵하고 Add Toolbar 를 선택하여 생성한다. 
새 도구띠 는 비 여있고 그 도구띠 핸들만 볼수 있 다. (도구띠 핸들은 보통 2개의 굵은 수직 
선이나 여러개의 자그마한 홈들을 포함하는 재색구역으로 표시된다.) 

丄 I I 

그림 1-30. 도구띠핸 들 

작용들은 Action Editor 편집기로부터 도구띠로 그것들을 끌고가서 요구하는 위치의 
도구띠에 놓는 방법으로 간단히 도구띠에 추가된다. (그 위치는 수직적색선으로 가리 
킨 다.) 

그림 1-31. 도구띠에 작용그룹을 끌고가기 

작용그름의 모든 작용들은 간단히 Action Editor 로부터 작용그를을 끌어 다 도구띠 
우에 놓는 한번의 이행으로 도구띠에 추가된다. 

보통 도구띠단추들은 오직 하나의 화상을 보여 주므로 도구띠 에 서 사용하려 는 모든 
작용들은 적당한 화상에로의 iconSet 속성모임을 가지고있어야 한다. 

도구띠단추들과 분리선(보통 울퉁불퉁한 수직재색선들로 표시된다.)들은 임의의 시간 
에 도구띠의 새 위치에로 끌어 다 놓을수 있다. 분리선들은 도구띠단추를 오른쪽 단추로 
찰칵하고 Insert Separator 를 선택하는 방법으로 삽입할수 있다. 도구띠단추들과 분리선 
들은 그것들을 오른쪽 단추로 찰칵하고 Delete Item 을 선택하여 삭제 할수 있다. 도구띠 는 
도구띠핸들을 오른쪽 단추로 찰칵하고 Delete Toolbar 를 선택하여 삭제할수 있다. 

응용프로그람을 미 리 보기 하면 각이 한 류동점 (QMainWindow 혹은 파생 클라스의 
상，하，좌，우)으로 모든 도구띠를 끌고다니거나 독립적인 도구창문들밖으로 도구띠를 
끌고갈수 있다는것을 알수 있다. 
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- 도구띠 에 창문부품의 추가 

때때로 간단한 단추는 우리의 요구를 만족시키지 못한다. 실례로 사용자가 도구띠 
로부터 서체이름과 서체크기를 선택할수 있게 하려면 도구띠단추로 서체대화칸을 펼치는 
것보다 직접적인 도구를 리용하는것이 더 좋을것이다. 

도구띠에 ComboBox 와 SpinBox 를 추가하는것은 완전히 편리하다. 실례로 
ComboBox 를 유효서 체이 름들을 렬 거 하는데 사용할수 있 으며 SpinBox 를 서 체 크기 를 
선택하는데 사용할수 있다. 

도구 띠에 창문부품을 넣을수 있지만 작용과 련결할수 있는 창문부품들을 도구 띠에 
직접 추가하지 않을것을 권고한다. 이 러한 창문부품들 즉 차림표항목과 도구 띠단추，항 
목목록들은 작용(항목목록일 때에는 내리펼침작용)을 생성하고 작용을 창문부품과 련결 
하고 작용을 도구 띠에 추가해야 한다. 

4) Options 작용의 추가 

Action Editor 의 첫 작용을 오른쪽 단추로 찰칵하고 New Action 을 선택한다. 
Property Editor 에는 새로운 작용의 속성들이 표시된다. 작용의 name 속성을 
options Action 으로 변경 한다. iconSet 속성에 대한 생략단추를 찰칵하여 Choose an 
Image 대화칸을 펼친다. Add 단추를 찰칵하여 Choose Images 대화칸을 연다. 
/ tools/designer/examples/colortool/images^ - 넘어간다. tabwidget.png 화상을 선 
택한다. 그것을 사용하기 위하여 Open 을 선택하고 OK 를 찰칵하면 Choose an Image 
대화칸이 열린다. text 속성을 Options 로, menuText 속성을 ^Options... 로 변경한다. 

Action Editor 에서 Options 작용을 선택 하고 Edit 차림 표까지 끌고간다. Edit 차림표 
는 펼쳐진다. Options 작용을 그 차림표아래로 끌고가서(붉은색 수평선은 그 위치를 보 
여준다.) Find 항목뒤의 끝에서 그것을 놓는다. 

- Options 작용을 추가하는 다른 수법 

차림표띠에서 Edit 를 찰칵하고 Find 차림표뒤에 있는 new item 을 찰칵하고 
&Options 라고 입력하여 이름을 변경하고 Enter 를 입력한다. 화살건을 Options 차림표 
항목(픽 스매프 마당)의 왼쪽까지 이동하고 Enter 를 누르면 Choose an Image 대화칸이 
열린다. Add 단추를 찰칵하여 Choose Images 대화칸을 연다. 

/tools/designer/examples/colortool/images 로 이 행 하여 tab widget, png 화상 
을 선택한다. 화상을 사용하기 위하여 Open 을 선택하고 OK 를 찰칵하면 Choose an 
Image 대화칸이 열린다. 그러면 픽 스매프 가 차림표의 Options 항목다음에 나타난다. 

Options 작용은 다른 Edit 차림표선택과 시각적으로 분리되여야 한다. 픔의 Edit 차 
림표를 선택하고 new separator 항목을 선택하고 Options 항목우의 공간으로 끌고간다. 


35 



또한 이 선택을 도구띠로부터 쓸수 있게 하려고 하므로 Options 작용을 선택하고 
그것을 도구띠로 끌고가서 확대경 ( Find ) 도구띠 단추(분리선뒤에)의 오른쪽에 놓는다. 붉 
은색 수평선은 끌기할 때 그 위치를 표시한다. 

이 작용을 후에 련결하고 코드를 작성한다. 

5) Add 작용의 추가 

Action Editor 의 첫 작용을 오른쪽 단추로 찰칵하고 New Action 을 선택한다. 작 
용의 name 속성을 editAddAction 으로， iconSet 속성을 designer _ widgetstack . png , 
text 속성 을 Add 토, menuText 속성 을 & Add ..., accel 속성 을 Ctrl + A 로 변경 한다. 
( CTRL + A 를 누르면 자동적으로 건결합이 마당에 나타난다.) 

Add 단추를 찰칵하고 그것 을 Edit 차림 표의 첫 항목으로 끌고간다. (그것 을 편집차 
림표로 끌고가서 붉은색 수평선이 Cut 차림표항목우에 놓일 때 놓는다.) 

- Add 작용의 다른 추가수법 

차림표띠에서 Edit 를 선택하고 Find 차림표항목뒤에 있는 new item 을 찰칵하고 
& Add 를 입력하여 이름을 변경하고 Enter 를 누른다. 화살건을 Add 항목왼쪽의 공간으 
로 이동하고 Enter 를 누르면 Choose an Image 대화칸이 열린다. Add 단추를 찰칵하여 
Choose Images ... 대 화칸을 열 고 / tools / designer / examples / colortool / images 로 이 
행 하여 tabwidget . png 화상을 선택 한다. 화상을 사용하기 위 하여 Open 을 선택하고 
OK 를 찰칵하면 Choose an Image 대화칸이 열린다. 그러면 픽스매프가 차림표의 
Op 仕 ons 항목다음에 나타난다. 끝으로 화살건을 Add 항목오른쪽의 공간으로 이동하고 
Ctrl + A 을 누르면 지름건결합이 Add 차림표항목다음에 나타난다. 

6) 정돈 

Cut 를 사용하여 색을 삭제할수 있지만 이름을 Delete 로 변경하여 그 의미를 더 명 
백 하게 한다. Action Editor 안의 editCutAction 을 선택 하여 Property Editor 에 그 속 
성들을 표시하게 한다. text 속성을 Delete 로， menuText 속성을 & Delete 로 변경한다. 

그렇지만 이러한 변경은 현재 Alt + C ( Cut 에 사용)를 사용하지 않는다. Action 
Editor 에서 editCopyAction 작용을 선택하고 menuText 속성을 技 Copy 로 변경한다. 

- Actions 작용이름을 변경 하는 다른 수법 

Cut 작용의 이름을 Delete 로 변경하기 위하여 차림표띠에서 Edit | Cut 를 찰칵하고 
技 Delete 라고 입력하고 Enter 를 누른다. 

Copy 작용의 이름을 & Copy 로 변경하려면 차림표띠에서 Edit | Copy 를 찰칵하고 
SCopy 라고 입력하고 Enter 를 누른다. 

Edit | Check Accelerators (혹은 Alt + R ) 를 눌러서 지름건경쟁 이 있는가 검사할수 있다. 

7) 작용그룹의 추가 
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사용자가 보기들을 선택할수 있게 하려고 하지만 한번에 하나의 보기만 사용할수 있으 
므로 보기 들사이 를 절환하는데 사용하는 차림 표선택 과 도구띠 단추들이 항상 동기 된다는것 을 
담보해야 한다. 코드로서 이것을 달성할수 없으므로 작용그롭에 련관된 작용들을 간단히 넣 
는다. 

Action Editor 에서 오른쪽 단추로 작용을 찰칵하고 New Action Group 를 선택하 
면 작용그룹의 속성들이 Property Editor 에 표시된다. 작용그룹의 name 속성을 
viewActionGroup 으로，그 text 속성을 View 로 변경한다. 작용그롭을 배타적으로 즉 
임의의 시각에 그룹의 작용들중 하나만 on 으로 하려고 하지만 exclusive 속성은 기정적 
으로 True 로 설정되 여있으므로 다시 설정 할 필요는 없다. 

그러면 보기작용들을 만들자. 이 과정은 작용그룹안에 있지 않는 작용들과 가상적 
으로 같다. 유일한 차이는 오른쪽 단추를 찰칵하여 문맥차림표를 펼칠 때 Action 
Editor 의 어떤 작용이 아니라 련관된 작용그룹을 오른쪽 단추로 눌러야 한다. 

년 6 짜쇼£仕 0 ] 1 (그 1 > 0111 )을 오른쪽 단추로 찰칵하고 New Ac 仕 on 을 선택한다. 이 작용의 
name 속성을 viewTableAction 으로 변경 한다. 그 toggleAc 仕 on 속성을 True 로，그 on 속성 
을 True 로 설정 한다. 사용자가 이 보기 ( on ) 를 사용하거 나 다른 보기 ( off ) 를 사용하고있으므 
로 그것을 절환작용으로 하려고 한다. 이 작용이 기정보기이므로 on 으로 설정한다. 그 
iconSet 속성을 table , png 로 변경하고 text 속성을 View Table 로， menuText 속성을 View 
STable 로 변경 한다. accel 속성을 Ctrl + T 로 변경하고 toolTip 속성을 View Table ( Ctrl + T ) 
로 설정 한다. 사용자가 View 차림표를 선택하고 View Table 우로 마우스를 가져가면 도구암 
시가 상태띠에 나타난다. 마찬가지로 사용자가 마우스를 View Table 도구띠단추우로 가져가 
면 도구암시 본문이 상태 띠 와 도구띠 단추결 의 황색 의 일 시 표식 자안에 나타난다. 

viewActionGroup 를 오른쪽 단추로 찰칵하고 New Action 을 선택한다. 이 작용 
의 name 속성을 viewIconsAction 로 변경하고 그 toggleAction 속성을 True , iconSet 
속성을 icon view , png 로, text 속성을 View Icons 로, menuText 속성을 View & Icons , 
accel 속성을 Ctrl + I 로， toolTip 속성을 View Icons ( Ctrl + I ) 로 변경한다. 

8) 작용그룹의 사용 

이제는 보기작용들을 만들었으므로 그것들을 사용자가 사용할수 있게 만들어야 한다. 

Action Editor 의 viewActionGroup 작용그룹을 선택하고 View 차림표로 끌고가서 
이 차림표우에 ( View 차림 표아래 에 붉은색 수평선이 나타날 때) 놓는다. 작용그룹을 끌 
기하였으므로 그의 모든 작용들(우리의 경우에 viewTableAction 과 

viewIconsAction ) 은 련관된 차림표에 추가된다. 또한 도구띠에서 보기작용들을 쓸수 
있게 만든다. viewActionGroup 을 다시 한번 찰칵하고 그것을 도구띠로 끌고가서 도구 
띠의 오른쪽에 있는 분리선의 오른쪽에 그것을 놓고 도구띠의 변두리에 놓는다. (다시 
붉은색 수직선이 그 위치를 가리킨다.) 
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작용안의것들을 미리보는데 Ctrl + T 를 사용할수 있고 정기적으로 File | Save (또는 
Ctrl + S ) 를 찰칵해 야 한다. 이제 보기도구띠단추와 차림표선택들을 누르면 도구띠단추와 
차림표항목들이 모두 자동적으로 동기되는것을 볼수 있다. 

5. 기본창문부품의 작성 

대 부분의 기 본창문형 응용프로그람은 차림 표띠 , 도구띠，상태 띠 와 중심창문부품으 
로 구성된다. 이미 차림표띠와 도구띠를 만들고 기본창문위자드를 통하여 
QMainWindow 를 만들었으므로 상태띠를 가질수 있다. 응용프로그람의 기본창문부품으 
로서 공통적으로 사용된 창문부품들은 QListView (나무보기를 제공)와 QTable , 
QTexlEdit 이다. 사용자들에게 같은 자료의 2가지 각이 한 보기들을 제공하려고 하므로 
QWidgetStack 를 기본창문부품으로 사용한다. QWidgetStack 는 그 자체의 시각적 인 표 
시를 가지지 않고 각 QWidgetStack 폐지에 한개이상의 창문부품들을 배치하며 이때 각 
폐지는 하나의 폼을 가전다. 그다음 사용자에게 폐지들을 절환하기 위한 기구를 제공한 
다. (이것은 QTabWidget 를 사용하는것과 원칙적으로 비슷하다.) 우리는 사용자들에게 
2개의 보기 즉 색과 그 이름들을 렬거하는 표형식보기와 색견본을 보여주는 그림기호에 
기초한 보기를 제공하려고 한다. 실례에서는 각 QWidgetStack 패지에 하나의 창문부품 
만 배치하지만 이것은 응용프로그람의 설계를 완전히 반영한다. 각 폐지에 여러개의 창 
문부품을 배 치할수 있다. 

Toolbox 의 Containers 단추를 찰칵하고 WidgetStack 를 선택한다. 종의 거의 중간을 눌 
리서 창문부품탄창을 배치한다. 창문부품탄창의 name 속성을 colorWidgetStack 로 변경한다. 



그림 1-32 .창문부품탄창의 배치 


38 













Qt Designer 를 사용하여 좀에 창문부품들을 배 치 할 때 대 체 로 오른쪽에 배 치 해 야 한다. 
그리고 배치된 창문부품들의 크기에 대하여 걱정할 필요는 없다. 실례로 표식자를 하나 배 
치하고 그 본문을 크기에 맞지 않게 변경하여도 문제는 생기지 않는다. 정확한 위치와 크기 
에 대 하여 걱정 하지 않아도 되는 원인은 Qt Designer 가 Qt 의 배 치들라스들을 사용하여 폼 
들을 자동적으로 배치하기때문이다. 우리는 창문부품들의 모임을 선택하고 Qt Designer 에 
게 그것들이 수직 혹은 수평으로，나란히 혹은 살창형식으로 배치해 야 한다는것을 알려주어 
야 하며 Qt Designer 는 그것들을 배치하고 크기를 적당히 조절한다. 

이 절 에 서 는 Qt Designer 의 배 치 편의 프로그람을 최 소로 사용한다. 3절 에 서 배 치 의 
사용법과 정보를 더 제공하고 여러개의 대화칸을 만든다. 

홈자체 를 선택 하고 Lay Out Vertically 도구띠 단추를 찰칵한다. 그러 면 창문부품탄창은 
전체폼안에 꽉 찬다. 이제는 창문부품탄창의 폐지들에 창문부품들을 이식할 준비가 되였다. 

File Edit View Help 



그림 1-33. 창문부품탄창의 확대 

Toolbox 의 Views 단추를 찰칵한다. Table 을 선택하고 창문부품탄창의 거의 중간 
을 찰칵한다. 표의 name 속성을 colorTable 로， numRows 속성을 0으로, readonly 속 
성을 True 로 변경한다. 

하나의 창문부품을 오른쪽 단추로 찰칵하여 그 문맥차림표를 펼치면 대부분의 경우 
에 첫 항목이 Edit 선택으로 된다. Table 창문부품은 이 점에서 다름이 없고 Edit 선택은 
행과 렬에 따라 제목들을 변경할수 있는 대화칸을 만든다. 

표를 오른쪽 단추로 찰칵하고 Edit …를 선택하여 Edit Table 대화칸을 호출한다. 1 
렬의 Label 을 Name 으로 변경한다. Colmnns 목록의 2를 선택하여 2렬의 표식자를 
Label 행 편집칸에 표시 한다. 2렬의 표식 자를 Hex 로 변경 한다. 같은 방법 으로 3렬의 표 
식자를 Web 로 변경한다. OK 를 찰칵하여 대화칸을 닫는다. 
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그림 1-34. Table 의 추가 

창문부품탄창을 찰칵하고 Lay Out Vertically 도구띠 단추를 찰칵한다. 현재 표는 
창문부품탄창에 꼭 들어가고 창문부품탄창으로 크기를 조절한다. (차례로 종크기를 조절 
하고 Ctrl + T 를 눌러서 미 리보기 하고 미 러보기한 폼의 크기를 조절한다.) 



그림 1-35. 수직배치 후 tanlePage 
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Object Explorer 에서 WStackPage 대상을 선택하고 name 을 tablePage 로 변경 한다. 

이제는 다음 폐지를 만들 준비가 되였다. 창문부품탄창을 오른쪽 단추로 선택하고 
문맥 차림표에서 Add Page 를 찰칵한다. 표는 표시되지 않았거 나 혹은 새 로운 창문부품 
탄창이 표를 포함하는 첫 창문부품탄창패지를 가리운다. Toolbox 에서 IconView 를 선 
택하고 창문부품탄창의 거의 중간을 찰칵한다. IconView 의 name 속성을 
colorlconView 로, 그 resizeMode 속성을 Adjust 로 변경 한다. 색 견본을 작은 칸에 표 
시하기 위하여 gridX 속성을 100으로 변경한다. 



그림 1-36. IconView 의 추가 

보통 설계할 때 IconView 항목들을 만드는것이 효과었지만 이 응용프로그람에는 적 
합하지 않다. IconView 를 오른쪽 단추를 찰칵하면 펼처지는 문맥차림표에서 Edit …를 눌 
러서 Edit Icon View 대화칸을 열고 Delete Item 을 눌러서 기정항목을 삭제하고 OK 를 찰 
칵한다. 

창문부품탄창을 선택 하고 Lay Out Vertically 도구띠 단추를 찰칵한다. 지 금 그림 기 
호보기는 창문부품탄창에 정확히 맞는다. 
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그림 1-37. 수직배치후 iconsPage 

Object Explorer 에서 WStackPage 객체를 선택하고 이름을 iconsPage 로 변경 한다. 

창문부품탄창을 오른쪽 단추로 찰칵하고 Previous Page 를 찰칵한다. 

이로써 응용프로그람의 기본창문을 위한 사용자대면부설계를 끝낸다. 폼을 미려본 
다면 View 차림 표선택 과 도구띠단추들이 효과가 없다. 이것은 이 차림표선택 들과 도구 
띠단추들에 의 하여 작용들이 발생 할 때 실행 해 야 할 코드를 쓰지 않았기때문이 다. 다음 
에 필요한 코드를 쓴다. 

6. 코드작성 

Qt Designer 로 설계한 코드를 쓰는 2가지 수법이 있다. 원시적인 수법은 이미 만 
든 매개 좀의 파생콜라스를 만들고 파생클라스에 모든 코드를 넣는것 이 다. Qt 3.0 으로부 
터 Qt Designer 는 한가지 방법을 제공한다. Qt Designer 에서 코드편집기를 사용하여 
코드를 직접 쓸수 있다 (4 절). 이 실례에서는 Qt Designer 에서 모든 코드를 쓴다(파생 
클라스수법도 있는데 그 실례는 5절을 참고). 

코드작성을 시작하기전에 폼변수들을 만들어야 한다. 실례로 보기가 갱신을 요구하 
는가 하는것을 추적하여야 한다. 사용자가 다른 보기에서 새로운 색모임을 적재하거나 
색 들을 추가, 삭제 하였기 때 문이 다. 

1) 성원변수의 추가 

Object Explorer 의 Members 타브를 선택 한다. Class Variables (바닥쪽으로)를 오 
른쪽 단추로 찰칵하고 Edit 를 선택한다. Edit Class Variables 대화칸이 펼쳐진다. Add 
단추를 찰칵하고 QMap < QString , QColor > m _ colors 라고 입 력 한다. 이 매프를 사용하 
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여 사용자의 색 이름을 색과 련결한다. 다시 Add 단추를 찰칵하고 bool m _ changed 라고 
입력한다. 이 변수를 사용하여 자료가 변경되였는가 아닌가를 추적한다. 이것은 가령 완 
료하거나 새 파일을 열 때 보관하지 않은 자료를 보관하겠는가 하는 질문을 사용자에게 
제시 한다. 



그림 1-38. 성원변수의 추가 

같은 방법 으로 QString m _ filename 을 추가하여 사용자가 연 파일들을 추적 할수 
있다. bool m _ table _ dirty 과 bool m _ icons _ dirty 를 추가한다. 표를 표시하고있을 때 
사용자가 색 을 추가하면 그림 기 호들을 변경 된것 으로 표식 함으로써 사용자가 그림 기 호보 
기를 변경한다면 그림기호보기가 갱신되게 할수 있다. bool m _ show _ web 를 추가하고 
이것을 사용하여 표에 색이 웨브색인가 아닌가를 가리키는 란을 요구하는가 아닌가를 기 
록한다. int m _ clip _ as 를 추가하고 이것을 사용하여 사용자가 File | Copy 를 선택하여 오 
려둠판에 복사하도록 할수 있다. QClipboard clipboard 를 추가하여 대 역오려둠판에 로 
의 지적자를 보관할수 있다. 끝으로 QStringList m _ comments 를 추가한다. 이것은 색 
파일들을 적재 하고 보관하는데 사용되며 후에 설명 한다. 

현재 다음과 같은 변수들이 있다. 

QMap<QString,QColor> m_colors; 
bool m_changed; 

QString m_filename; 
bool m_table_dirty; 
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bool m icons dirty ; 

bool m show web ; 

int m _ clip _ as ; 

QClipboard * clipboard ; 

QStringList m_comments ； 

Enter 를 눌러서 마지막 변수를 확인하고 OK 를 찰칵하여 대화칸을 닫는다. 현재 
모든 변수들이 Object Explorer 의 Members 타브에 표시된다. 

2) 앞방향선언의 추가 

이미 만든 일부 변수들은 앞방향선언을 요구하는 클라스들의 객체이다. Object 
Explorer 의 Members 타브에서 Forward Declarations 를 오른쪽 단추로 찰칵하고 
Edit 를 선택 한다. 그러면 Edit Forward Declarations 대화칸이 펼쳐진다. 이 대화칸은 
방금 리 용한 Edit Class Variables 대화칸와 같은 방법 으로 작업 한다. 다음의 앞방향선 
언을 추가한다. 즉 class QString ; 와 class QColor 를 추가한다.. 대화칸을 닫으면 앞 
방향선언들이 Object Explorer 에 표시된다. 



그림 1-39. 앞방향선언의 편집 
결과 다음과 갈은 앞방향선언이 추가되게 되 였다. 
class QString ; 
class QColor ; 

3) 머리부의 추가 
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또한 좀은 머리부파일들을 요구한다. 머리부파일들을 선언이나 실현에 추가할수 있 
다. Includes (in Implementation ) 을 오른쪽 단추로 찰칵하고 Edit 를 누른다. 이때 열 
리는 대화칸을 통하여 qcolor . h 와 qstring . h 을 입력한다. 오려둠판을 사용하려면 
QApplication 을 거처서 대역 오려 둠판을 호출해야 하므로 qapplicaUon . h 와 
qclipboard . h 를 추가한다. 또한 그리기조작 (례 하면 색견본) 을 하기 위 하여 
qpaintenh 도 추가하고 대화칸을 닫는다. 



그림 1-40. 머리부의 추가 

머리부파일을 입력할 때 2중인용표나 각괄호를 포함할수 있다. 괄호를 사용하지 않 
으면 Qt Designer 는 자동적으로 2중인용표에 넣는다. 

실현파일에 다음의 머리부를 추가한다. 

" qcolor . h " 

" qstring . h " 

" qapplication . h " 

" qclipboard . h " 

" qpainter . h " 

4) 신호와 처 리부의 련결 

대 부분의 신호-처 리 부련결 은 기 본폼을 작성할 때 기 본창문위 자드에 의하여 자동적 
으로 창조된다. 그다음 새로운 작용들을 추가한다. 작용들의 동작에 대한 코드를 쓸수 
있도록 그것 들이 처 리부에 련결되 여있어 야 한다. 


45 












그림 1-41. 신호와 처리부의 련결 (1) 

- 신호-처리부련결의 작성 

Edit | Connections 을 찰칵하여 View and Edit Connections 대 화칸을 펼친 다. 

보통 이 대화칸의 사용은 같은 본보기를 따른다. New 를 찰칵하여 새 련결을 생성 
하고 Sender 창문부품，송신기의 Signal , Receiver (보통 좀)을 선택한다. 미리 정의된 
처 리부를 사용하려 고 한다면 그 처 리부를 선택 하고 그렇 지 않으면 Edit Slots ... 를 선택 
하여 새 처리부를 만들고 새로 만든 처리부를 선택한다. (련결을 선택하여 끌고가는 이 
전의 방법이 여전히 지원되지만 새 방법은 한번의 이행으로 여러개의 련결을 만들 때 특 
별히 더 빠르고 더 간단하다.) 

상태 띠를 갱신하여 사용자가 색정 보를 볼수 있게 하려고 한다. Edit | Connections 
을 찰칵하여 View and Edit Connec 仕 ons 대화칸을 열고 New 를 눌러서 새 련결을 만 
든다. Sender 를 colorTable 로, Signal 을 currentChanged ( int ， int ) 로, Receiver 를 
MainForm 으로 변경한다. 
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그림 1-42. 신호와 처리부의 련결 (2) 

아직 만들지 않은 자체의 전용처리부에 련결하려고 한다. Edit Slots 단추를 찰칵하 
여 Edit Functions 대화칸을 열고 New Function 를 찰칵하고 처리부이름을 
changedTableColor ( int ， int ) 로 변경한다. OK 를 찰칵하여 대화칸을 닫는다. 



그림 1-43. changedTableColorQ 함수의 편집 
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그다음 View and Edit Connections 대화칸에서 Slot 를 새로 만든 

changedTableColor ( int , int ) 로 변경 한다. 



그림 1-44. currentChangedO 신호와 changedTableColor () 처리 부의 련결 

New 를 찰칵하여 새 련결을 만들고 Sender 를 colorlconView 로， Signal 을 
currentChanged ( QlconViewItem *) 로， Receiver 를 MainForm 로 변경 한다. Edit 
Slots …단추를 찰칵하여 Edit Functions 대화칸을 펼치고 New Function 을 찰칵하고 
처리부이름을 changedIconColor ( QIconViewItem *) 로 변경한다. OK 를 찰칵하여 대 
화칸을 닫는다. View and Edit Connections 대화칸에서 Slot 를 

changedlconColor ( QlconViewItem *) 로 변경 한다. 

이제는 changedTableColorO 와 changedlconColorO 처리부들을 실현하여 상태 
띠를 현재색에 대한 설명으로 갱신할수 있다. 

또한 사용자가 보기 를 변경할 때 보기 에 보여 준 색 이 정 확하다는것 을 담보하려 고 
한다. 실례로 사용자가 표의 색을 삭제하여 그림기호보기를 변경하였다면 그림기호보기 
가 삭제된 색을 표시하지 않도륵 담보해야 한다. 

New 를 찰칵하여 새 련결을 만들고 Sender 를 colorWidgetStack 로， Signal 을 
aboutToShow ( int ) 로, Receiver 를 MainForm 으로 변경한다. aboutToShowO 라는 
새 처리부를 만들고 이것을 창문부품탄창의 aboutToShow ( int ) 신호를 련결하는 처리 
부로 만든다. 신호는 표시 하려 는 창문부품의 ID 를 포함하지 만 파라메터 를 가지 지 않는 
처 리부를 창조하므로 그것을 요구하지 않는다. 

하나의 중요한 기능은 사용자가 보기들사이를 절환하게 하는것이다. 매개 보기작용들을 
따로따로 결합할수 있지만 모두를 작용그룹으로 결합하면 더 편리하고 확장하기 쉽다. 
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Sender 로서 viewActionGroup 를 가지는 새 련결을 만들고 Signal 을 
selected ( QAction *) 로， Receiver 를 MainForm 으로 변경한다. changeView ( QAction *) 
라는 처리부를 만들고 이것을 신호가 련결하는 처리부로 만든다. 

◦ KM * 찰칵하여 View and Edit Connections 대화칸을 연다. 이제는 코드를 쓸 준 
비가 되였다. 



그림 1-45. 신호와 처리부의 련결 

5) 설정코드의 편집 

응용프로그람에 포함할 코드는 매우 많지만 많이 입력해야 한다는것을 의미하지 않는다. 
Project Overview 창문에서 mainform . ui . h 를 찰칵한다. 빈 처리부를 표시하는 
코드편집 기 창문이 나타난다. 

- 상수의 추가 

const int CLIP _ AS_HEX = 0; 
const int CLIP 一 AS_NAME = 1; 
const int CLIP _ AS_RGB = 2; 
const int COL NAME = 0; 



const int COL WEB = 2; 

const QString WINDOWS 一 REGISTRY = "/ QtExamples "; 
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const QString APP_KEY = "/ColorTool/，，; 

2 보다 CLIP_AS_RGB 를 기 억 하기 쉬우므로 좀에 사용할수 있는 상수들을 정의 한 
다. 사용자의 선택을 적재하고 보관할 때 2개의 QString 을 QSettings 에서 사용한다. 
그것들은 loadOptions 0와 saveOptions 0에서 설명 한다. .ui.h 파일에 상수선언과 
Wnclude 를 비 롯하여 유효한 C++ 를 삽입할수 있 다. 

파생콜라스를 만들지 않으므로 구성시에 실행되는 코드를 요구한다면 initO 함수를 
만들어야 한다. 이것은 종구성자의 끝에서 호출된다. 

- init() 

void MainForm::init() 

{ 

clipboard = Q Application: : clipboard(); 
if ( clipboard->supportsSelection() ) 
clipboard->setSelectionMode( TRUE ); 


findForm = 0; 
loadSettings(); 
m_filename = 
mchanged = FALSE; 
mtabledirty = TRUE; 
m_icons_dirty = TRUE; 
clearData( TRUE); 

} 

처음에 대 역오려둠판객체 에 로의 지적 자를 얻는다. setSelectionModeO 호출은 오려둠 
판이 모든 가동환경들에서 기대한대로 작업한다는것을 담보한다. findForm 과 
loadSettingsO 행들은 후에 학습한다. 코드를 입력하고있다면 현재는 그것들을 설명문으 
로 한다. 사용자가 파일을 열지 않았으므로 파일이름을 비운다. 아직 어떤 변경도 없으므 
로 변경을 거짓으로 설정한다. 그러나 표와 그림기호보기를 직접 그리려고 하지 않으므로 
그것들을 모두 변경 한것 (dirty) 으로서 표식 한다. 다음번에 쓰러는 clearDataO 함수를 호 
출한다. 이 함수는 모든 색자료를 지우고 TRUE 로 호출되면 기정값을 가지는 새로운 색 
들을 만든다. 

- clearData() 

void MainForm: : clearData( bool fillWithDefaults ) 

{ 

setCaption( ’’Color Tool” ); 
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m_colors.clear(); 
mcomments .clear(); 


if ( fillWithDefaults ) { 
m_colors[’’black"] ■ Qt::black; 
m_colors["blue"] = Qt::blue; 
m_colors[’’cyan"] = Qt::cyan; 
m_colors [" darkblue"] = Qt::darkBlue; 
m_colors [ "darkcyan"] = Qt::darkCyan; 
m_colors [ "darkgray" ] = Qt::darkGray; 
m_colors["darkgreen"] = Qt::darkGreen; 
mcolor s ['' darkmagenta'' ] = Qt::darkMagenta; 
m_colors[’’darkred"] = Qt::darkRed; 
m_colors[ M darkyellow"] = Qt::darkYellow; 
m_colors[’’gray"] = Qt::gray; 
m_colors["green"] Qt::green; 

m_color s ['' lightgray" ] = Qt::lightGray; 
m_colors[ "magenta"] = Qt::magenta; 
m_colors["red’’] = Qt::red; 
m_colors [ "white" ] = Qt::white; 
m_colors["yellow"] = Qt::yellow; 

} 

populate(); 

} 

이 함수는 응용프로그람을 기동할 때와 사용자가 새 파일을 만들거나 현존파일을 
적재할 때 사용된다. 이때 자료를 지우고 선택적 으로 기정색 들을 삽입한다. 파일들을 적 
재 하고 보관할 때 파일 이 름을 제 목에 추가하므로 응용프로그람의 제 목을 설정한다. 또한 
삭제할 때 에는 제목으로부터 파일 이름을 지워 야 한다. 색매프와 설명문자렬목록을 지우 
고 선택 적 으로 색 략도를 표준색 으로 채 운다. 끝으로 표와 그림기 호보기 에 자료를 채우는 
populateO 를 호출한다. 

- populate() 

void MainForm: : populate() 

{ 
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if ( m table dirty ) { 

for ( int r = 0; r < colorTable->numRows(); ++r ) { 
for ( int c = 0; c < colorTable->numCols(); ++c ) { 
colorTable->clearCell( r, c ); 

} 

} 


colorTable->setNumRows( m_colors.count() ); 
if ( ! m_colors.isEmpty() ) { 

QPixmap pixmap( 22, 22 ); 
int row = 0; 

QMap<QString,QColor> :: Constlterator it; 

for ( it = m_colors.constBegin(); it != m_colors.constEnd(); ++it ) { 
QColor color = it.data(); 
pixmap.fill( color ); 

colorTable->setText( row, COL NAME, it.key() )； 
colorTable->setPixmap( row, COL NAME, pixmap ); 
colorTable->setText( row, COL HEX, color.name().upper() ); 
if ( m show web ) { 

QCheckTableltem *item = new QCheckTableItem(colorTable, ,M, ); 
item->setChecked( isWebColor( color ) ); 
colorTable->setltem( row, COL WEB, item ); 

} 

row++; 

} 

colorTable->setCurrentCell( 0, 0 ); 

} 

colorTable->adjustColumn( COL NAME ); 
colorTable->adjustColumn( COL HEX ); 
if ( m show web ) { 
colorTable->showColumn( COL WEB ); 
colorTable->adjustColumn( COL WEB ); 

} 

else 
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colorTable->hideColumn( COL WEB ); 
mtabledirty = FALSE; 

} 

if ( m_icons_dirty ) { 
colorlconV iew->clear(); 

QMap<QString,QColor>::ConstIterator it; 

for ( it = m_colors.constBegin(); it != m_colors.constEnd(); ++it ) 

(void) new QlconViewltem( colorlconView, it.key(), 
colorSwatch( it.data() ) ); 
miconsdirty = FALSE; 

} 

} 

이 함수는 응용프로그람의 심장부이다. 이것은 사용자에게 자료를 시각적으로 제시 
한다. 표가 갱 신되 였으면 (실례로 사용자가 그림기 호보기에서 색을 추가 혹은 삭제 하거 나 
색 파일을 열었다면) 표를 구성한다. 각 세포의 내용을 삭제하는것으로 시 작한다. 다음에 
색 략도의 색수와 같게 행수를 변경한다. 매개 색에 대하여 색을 보여주는 작은 장방형을 
표시 하기 위하여 요구되는 크기의 픽스매프를 만든다. 

이제 색매프용 반복자를 생성하고 매개 색을 순환한다. 색매프는 사용자의 색이름 
과 값으로서 QColor 실례를 가전다. 색을 엄어서 그 색으로 픽스매프를 채운다. 그다음 
색이 름 (it.key 0) 과 그 색 으로 채 운 픽 스매 프를 얻 기 위하여 Name 칸 (COL_NAME 칸) 
을 설정한다. QColor 의 nameO 함수는 색의 16 진표시인 문자렬 례하면 #12AB2F 를 
돌려준다. 이것을 엄 어서 둘째칸 (Hex) 을 이 값으로 설정 한다. 

사용자가 색 이 웨브색 인가 알아보려면 QCheckTableltem 을 생성하고 그것 이 웨브 
색인가 검사한다. (간단히 isWebColorO 를 호출한다.) 그다음 이 QCheckTableltem 
을 Web 란에 삽입 한다. 

표를 구성하고 adjustColumnO 를 호출하여 매개 칸이 그 창문부품항목에 충분한 
폭을 가지며 사용자의 선택에 따라 Web 칸을 표시 혹은 숨기도록 해야 한다. 

끝으로 m_table_dirty 를 FALSE 로 설정하여 갱신한다. 

그림기호보기가 갱신되였으면 현존자료를 지운다. 그다음 색매프의 매개 색을 순환 
한다. 매 개 색 에 대 하여 새 로운 QlconViewItem 을 생 성 한다. 사용자의 색이 름을 가지 
는 항목을 표식 하고 련관된 색 으로 된 픽 스매프 (colorswatch 0 에 의 해 간단히 생성)를 
제공한다. 끝으로 m_icons_dirty 를 FALSE 로 설정하여 갱신한다. 
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isWebColorO 

bool MainForm: : isWebColor( QColor color ) 

{ 

int r = color.red(); 
int g = color.green(); 
int b = color.blueQ; 


return ( ( r = 0 || r == 51 || r = 102 || 

r = 153 || r == 204 || r = 255 ) && 

( S ^ 0 II f ■■ 훈 ，' 151 II 102 II 

g = 153 || g = 204 || g == 255 ) && 

( b == 0 || b == 51 || b == 102 || 

b == 153 || b = 204 || b = 255 )); 

} 

216 웨브색은 RGB 값들이 모두 모임 (0, 51, 102, 153, 204, 255) 안에 있는 색들이 다. 

- colorSwatch() 

QPixmap MainForm: : colorSwatch( const QColor color ) 

{ 

QPixmap pixmap( 80, 80 ); 
pixmap.fill( white ); 

QPainter painter; 
painter.begin( &pixmap ); 
painter.setPen( NoPen ); 
painter.setBrush( color ); 
painter.drawEllipse( 0, 0, 80, 80 ); 
painter.end(); 
return pixmap; 

} 

적당한 크기의 픽스매프를 생성하고 그것을 흰색으로 채운다. 그다음 픽스매프를 
그리는데 사용하는 QPainter 를 생성하다. 그리려는 도형주위에 륜곽선이 필요없으므로 
펜을 요구하지 않는다. 80X80 화소의 정 방형안에 타원 (즉 원)을 그린다. 결과 픽스매 프 
를 돌려준다. 

6) main.cpp 의 작성 
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일부 코드를 입력하였으므로 응용프로그람을 건설실행하여 그 동작을 볼수 있다. 
그러기 위 하여서는 main () 함수를 만들어 야 한다. 일반적으로 Qt 에서는 main () 함수용으 
로 작은 main, cpp 파일을 만든다. Qt Designer 에 의 해 이 파일을 만들수 있다. 

• File | New 를 눌러서 New File 대화칸을 펼친다. C++ Main-File 을 선택하고 OK 
를 찰칵한다. Configure Main - File 대화칸이 열리고 프로젝트안의 모든 폼들이 렬거된 
다. 하나의 폼 MainForm 만 만들었으므로 그것 이 이 미 선택 되 여 있 다. OK 를 찰칵하여 
MainForm 을 적재 하는 main, cpp 파일을 생성 한다. 

#include <qapplication.h> 

#include "mainform.h" 

int main( int argc, char ** argv ) 

{ 

QApplication a( argc, argv ); 

MainForm *w = new MainForm; 

w_>show(); 

return a.exec(); 

} 

Qt Designer 가 main.cpp 파일을 생성할 때 다음의 행을 포함한다. 

a.connect( &a, SIGNAL( lastWindowClosed() ), &a, SLOT( quit() ) ); 

이 코드를 그대 로 놔두면 사용자는 기 본창문의 닫기 (X) 단추를 찰칵하여 자체 의 완 
료코드를 무시할수 있 다. 사용자에 게 보관되 지 않은 변경 을 보관하는 선택 을 줄수 있 다. 
이것을 달성 하기 위하여 그 련결을 삭제 하고 응용프로그람을 담으려 는 시도를 차단하고 
fileExitO 함수를 호출하는 새로운 처리부 closeEventO 를 추가한다. 

• Project Overview 창문에서 main.cpp 를 찰칵한다. 편집창문에 파일 이 나타난다. 
련결행을 삭제 한다. 

•Project Overview 창문에서 mainform.ui.h 를 찰칵한다. (우선 mainform.ui 을 
선택 하여 mainform. ui. h 을 표시 한다) . Object Explorer 의 Members 목록 (Slots, 
public) 에서 fileExitO 를 오른쪽 단추로 선택하고 Goto Implementation 을 찰칵한다. 
fileExitO 처리부우에 다음의 처리부를 추가한다. 
void MainForm: : closeEvent( QCloseEvent * ) 

{ 

fileExitO; 

} 
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그러면 사용자가 응용프로그람을 담으려고 할 때 fileExitO 처리부가 호출된다. 
fileExitO 처리부의 코드를 작성하자. 
void MainForm: : fileExit() 

{ 

QApplication::exit( 0 ); 

} 

이것은 응용프로그람이 정확히 완료되는것을 담보한다. 후에 이 함수를 갱신하여 
사용자에게 보관되지 않은 변경을 보관할 기회를 주게 한다. 

7) 건설과 실행 

이리하여 응용프로그람의 코드와 mainO 함수를 포함하는 main.cpp 를 가지게 되였 
으므로 응용프로그람을 롬파일，련결，실 행할수 있 다. 

FilelSave 를 찰칵하여 모든 작업이 디스크에 보관되도록 한다. 말단창문(실례로 
xterm 이나 DOS 창문)을 열고 등록부를 colortool 프로젝트를 보관하려는 곳으로 변경하 
고 qmake 를 실행 하여 Makefile 을 만든다. 
qmake _o Makefile colortool.pro 

다음 프로젝트를 만든다. (Windows 에서 nmake, 다른 가동환경 에서 make 를 실행 
한다. ) initO 함수에서 설명 문으로 한 findForm 과 loadSettings 행 들을 제 공하여 프로그 
람을 건설해야 한다. 

make 가 완료하면 프로그람을 실행한다. 아직 보기를 변경할수 없지만 기정색모임 
을 생성한다. 닫기 (X) 단추 혹은 FilelExit 를 눌러서 응용프로그람을 완료할수 있다. 

8) 상태띠의 갱신코드편집 

상태띠에 현재색에 대한 정보를 표시하고 사용자가 보기를 변경하거나 색파일에 적 
재할 때 련관된 보기가 갱신된다는것을 담보하려고 한다. 

- aboutToShow() 

void MainForm: : aboutToShow() 

{ 

populate(); 

} 

populateO 처리부를 만들고 그것을 직접 호출한다. 우리는 간접적방법을 사용한다. 
왜냐하면 그것이 더 명백하고 실제 응용프로그람에서 이 처리부에서 진행하는 경우가 아 
마 더 많기때문이다. 

- changedTableColor() 

void MainForm: : changedTableColor( int row, int ) 

{ 
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changedColor( colorTable->text( row, COL 一 NAME ) ); 

} 

사용자가 표보기에서 이동하거나 마우스를 눌렀는가를 알아내도록 하기 위하여 이 처 
리부에 련결한다. 현재색의 이름으로 changedColorO 함수를 호출한다. column 인수를 
고려 하지 않으므로 그것 을 남겨 둔다. changedTableColor 파라메 터 의 이 름을 ’’int row” 
로 하였다. 

- changedIconColor() 

void MainForm: : changedIconColor( QlconViewltem *item ) 

{ 

changedColor( item->text()); 

} 

이 처리부는 우의 changedTableColor () 와 같은 목적으로 련결된다. 또한 현 
재색의 이름으로 changedColorO 를 호출한다. (코드를 자르기하여 붙이기하는 경우 
에 QlconViewItem 파라메터의 이름을 item 으로 하였다는것을 잊 어서는 안된다.) 

- changedColorO 

간단히 코드를 Qt Designer 의 코드편집기에 입력하면 Object Explorer 의 
Members 타브 (Functions, public 아래)에 자동적으로 표시된다. 

기정으로 코드편집기에 직접 입력한 함수는 공개함수로 된다. 이것을 변경하려면 
Object Explorer 의 Members 목록에서 함수이 름을 오른쪽 단추로 찰칵하고 Properties 
를 선택하여 Edit Functions 대화칸을 펼친 다음 처리부로의 변경을 비롯하여 함수의 
여러가지 속성을 변경할수 있다. 

void MainForm: : changedColor( const QString& name ) 

{ 

QColor color = m_colors[name]; 
int r = color.red(); 
int g = color.green(); 
int b = color.blue(); 

statusBar()->message(QString( M %l \"%2\" (%3,%4,%5)%6 {%7 %8 %9}" ). 
arg( name ). 

arg( color.name().upper() ). 

arg( r ).arg( g ).arg( b ). 

arg( isWebColor( color ) ? " web" : ”" ). 

arg( r / 255.0, 1, ， f, 3 ). 

arg( g / 255.0, 1, ， f, 3 ). 
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arg( b / 255.0, 1， ，f, 3 ) 


이 함수는 색 매 프에 서 색이 름을 찾고 이 름이 제 공하는 색 을 엄 는다. 그다음 이 름과 
16진값，색 이 웨 브색 인가 아닌가를 상태 띠 에 표시한다. 

QMainWindow 는 실제로 상태띠를 사용하다면 그것을 만든다. 우리가 지금까지 
그것을 사용하지 않았으므로 문제가 없었지만 름파일하려고 하면 현재 상태띠를 사용하 
고있으나 련관된 머리부를 선언하지 않았으므로 오유가 발생한다. Object Explorer 의 
Members 타브를 누르고 qstatusbar. h 를 Includes (In Implementation) 절 에 추가한다. 
Includes (In Implementation) 을 오른쪽 단추로 찰칵하고 New 를 누르고 
qstatusbar. h 를 입력하고 Enter 를 누른다. 

이제는 머리부(실현)에 다음의 선언을 추가해야 한다. 

• "qstatusbar. h" 

Ctrl+S 를 눌러서 응용프로그람을 보관하고 구축하고 실행한다. 각이한 색으로 이동 
하면서 상태띠에서 색을 설명하고있는가를 확인한다. (건설되지 않으면 3절. 6을 참고.) 

- 보기의 변경 

지금까지는 보기를 절환하는 코드가 없으므로 작용에서 그림기호보기를 확인할수 
없다. 이제 이 문제를 해결하자. 

사용자가 보기도구띠단추 혹은 차림표선택을 눌렀을 때 호출되는 changeViewO 
처 리부를 이미 만들었으므로 코드를 씨 야 한다. 
void MainForm: : changeView(QAction* action) 

{ 

if ( action == viewTableAction ) 

colorWidgetStack->raiseWidget( tablePage ); 
else 

colorWidgetStack->raiseWidget( iconsPage); 

} 

9) 파일조종코드의 편집 

X협회가 이미 색과 색이름을 련결하기 위한 파일형식을 정의하였으므로 응용프로그 
람용으로 따로 만들지 않고 그 파일형식을 사용한다. 이것은 rgb.txt 를 읽고쓸수 있게 
하며 이 형식이 다른 사용자들에게 친숙해질수 있는 우점을 가지고있다. 

- fileNew() 

void MainForm: : fileNew() 

{ 
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if ( okToClear() ) { 
m_filename = 



m_table_dirty = TRUE; 
m_icons_dirty = TRUE; 
clearData( FALSE); 


} 

} 

이 함수는 자료를 적재하거 나 보관하지 않고 단순히 현존자료를 지우는것 이 좋겠는 
가를 okToClear() 를 호출하여 확인하고 좋으면 픔을 초기화한다. 

- okToClearO 

새로운 색모임을 생성하거나 현존모임을 적재하기전에 보관되지 않은 변경이 있는 
가 확인해야 한다. 있다면 사용자에게 그 자료를 보관할 기회를 주어야 한다. 그것을 이 
함수가 수행 한다. 

bool MainForm: :okToClear() 

{ 



QString msg; 

if ( m filename.isEmptyO ) 
msg = "Unnamed colors 
else 

msg = QString( ’’Colors ’%l’\n" ).arg( m 一 filename ); 
msg += QString( "has been changed." ); 
int ans = QMessageBox: : information(this, 

"Color Tool - Unsaved Changes", msg, "&Save", "Cancel”, 

， ’ &Abandon n , 0, 1 ); 
if ( ans == 0 ) 
fileSave(); 

else if ( ans == 1 ) 
return FALSE; 

} 

return TRUE; 

} 

자료가 변경되였으면 (m_changed 가 TRUE 이면) 사용자에게 자료를 보관하는가 
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아니면 현재 조작을 취소(실례로 새 과일을 적재하지 않거나 새로운 색모임을 생성하지 
않는다 ) 하는가，변경을 무시하고 계속하는가 하는 선택을 제공하는 통보창문을 표시한다 . 
Save 단추를 기 정단추로 만들고 (Enter 를 누른다 . ) Cancel 단추를 취 소단추 (Esc 를 누른 
다.)로 만든다 . 

QMessageBox 를 사용하므로 련관된 머리부를 포함해야 한다 . (Includes (in 
Implementation) 를 오른쪽 단추로 찰칵하고 New 를 누른다 . qmessagebox. h 라고 입 
력 하고 Enter 를 누른다 .) 

이제는 실현의 머리부에 다음의 선언을 추가해야 한다 . 

•’’qmessagebox.h” 

fileOpen() 

void MainForm: : fileOpen() 

{ 

if ( ! okToClear() ) 
return; 

QString filename = QFileDialog: : getOpenFileName( 

QString::null, "Colors (*.txt)" ， this, 

"file open", "Color Tool - File Open" ); 



load( filename ); 


else 

statusBar()->message( "File Open abandoned", 2000 ); 

} 

자료를 지우면 안되 는 경우에(즉 사용자가 변경 을 보관하지 않았는데 okToClearO 에 의 하 
여 펼쳐진 통보창문에서 Cancel 을 눌렀을 때 ) 단순히 되돌아간다 . 그렇지 않으면 
QFileDialog 의 정적함수를 리용하여 사용자로부터 파일이름을 엄은 다음 파일을 적재한다 . 

QFileDialog 를 사용하므로 련관된 머 리부를 포함한다 . (Includes(in 

Implementation ) 를 오른쪽단추를 찰칵하고 New 를 선택 한다 . qfiledialog.h 라고 입력 
하고 Enter 를 누른다 .) 

이제는 실현의 머리부들에 다음의 선언을 추가한다 . 

"qfiledialog.h" 

- load() 

void MainForm: :load( const QString& filename ) 

{ 


60 



clearData( FALSE ); 
m_filename = filename; 

QRegExp regex( , ， A \\s*(\\d+)\\s+(\\d+)\\s+(\\d+)\\s+(\\S+.*)$ M ); 

QFile file( filename ); 

if ( file.open( IO ReadOnly ) ) { 

statusBar()->message( QString( "Loading ). arg( filename ) ); 

QTextStream stream( &file ); 

QString line; 

while ( ! stream.eof() ) { 
line = stream.readLine(); 
if ( regex. search( line ) == -1 ) 
mcomments += line; 
else 

m_colors[regex.cap( 4 )] = QColor( regex.cap( 1 ).toInt(), 

regex.cap( 2 ).toInt(), regex.cap( 3 ).toInt() ); 

} 

file.close(); 

m_filename = filename; 

setCaption( QString( ’’Color Tool - %1" ).arg( m_filename ) ); 
statusBar()->message( QString( "Loaded ’%1’" ). arg( m filename ), 3000 ); 
QWidget *visible = colorWidgetStack->visibleWidget(); 
m icons dirty = ! ( m_table_dirty = ( visible == tablePage ) ); 
populate(); 

m icons dirty = ! ( m table dirty = ( visible != tablePage ) ); 
mchanged = FALSE; 

} 

else 


statusBar()->message( QString( "Failed to load ’%1’" ). 
arg( m filename), 3000 ); 

} 

새 자료를 적재하기전에 현존자료를 지워야 한다. rgb.txt 파일의 형식은 다음과 같다. 

RED WHITESPACE GREEN WHITESPACE BLUE WHITESPACE NAME 
여기서 RED 와 GREEN, BLUE 는 0 〜 255 범위의 10 진수로서 필요한 곳에 공백이 
들어있는 3 개 문자로 이 루어 진다. 색 들사이의 WHITESPACE 는 보통 하나의 공백 이 고 
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BLUE 와 NAME 사이의 WHITESPACE 는 2 개의 타브이 다 . NAME 은 공백을 포함할수 
있다 . 실례로 

0 191 255 연하늘색 

176 48 96 밤색 

199 21 133 중간붉은보라색 

또한 파일은 설명행을 포함할수 있다 . 이것들은 실례에서 ’!’로 시작한다 . 

이 파일들의 구문을 해석하는 수법은 많지만 간단한 정규표현 (regex ) 을 선택하였다 . 
정규표현은 형식요구보다도 입력에서 공백에 관하여 더욱《자유적》이다 . 

한 행이 정규표현과 일치하면 QMap 형의 m_colors 에 새 항목을 생성하고 그 본문 
을 색 이 름 (regex. C ap( 4 )) 으로，그 값을 새 로운 적 록청값들로부터 생성된 QColor 로 설정 
한다 . 정규표현과 일치하지 않는 행들은 설명문으로 취급되고 m_comments 문자렬목록 
에 보관된다 . (파일을 보관할 때 파일중간에서 나타나더 라도 모든 설명문을 쓴다 .) 

일단 m_colors 매프를 구성하면 현재 보이는 보기를 변경된것으로 표식하고 
populate () 를 호출하여 그것을 갱신한다 . 그다음 보이는 보기를 변경되지 않은것으로 표 
식 하고 보이지 않는 보기 를 변경된것 으로 표시한다 . 이것은 사용자가 보기 를 변경할 때 
절환하는 보기를 갱신한다는것을 담보한다 . 단순히 2 개 보기를 변경된것으로 표식하고 
둘다 갱신하지만 천천히 갱신하는것이 더 효과있다 . 결국 사용자는 하나의 보기만 사용 
하므로 다른 보기를 필요없이 갱 신하는데 시 간을 량비 하지 않게 한다 . 

QFile 과 QRegExp 를 사용하므로 관련머리부를 포함한다 . (Includes (in 
Implementation ) 를 오른쪽 단추로 찰칵하고 New 를 선택한다 . qfile.h 라고 입력하고 
Enter 를 누른다 . 이 과정을 반복하여 qregexp.h 를 추가한다 .) 

실현파일의 선두에 다음의 선언들을 추가한다 . 

"qfile.h" 

"qregexp.h" 

정규표현 

우리가 사용하는 정규표현은 다음의 부분들로 나눌수 있다 . 

정 규표현 : A \\s* (\\d+) \\s+ (\\d+) \\s+ (\\d+) \\s+ (\\S+.*) $ 

부분 : ABC DC DC D E F 

괄호 : cap(l) cap(2) cap(3) cap(4) 

부분 A 는 정규표현이 문자렬의 시작과 일치해야 한다는것을 말하며 부분표는 정규표 
현이 문자렬끝과 일치해야 한다는것을 말한다 . 따라서 정규표현은 문자렬과 완전히 일치 
하거 나 일 치 하지 말아야 한다 . B 부분은 0 이 상의 공백 (즉 유효공백 )과 일 치 하고 부분 D 는 
1 개 이 상의 공백 (즉 매 개 수자사이 의 짱 ) 과 일 치한다 . 부분 C 는 한개 이 상의 수자들 즉 수 
와 일 치한다 . 부분표는 다른것 이 뒤 따르는 한개 이 상의 비 공백 즉 색이 름과 일 치 한다 . 
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괄호는 그것들이 둘러싸는 일치부분들을 둘러싸는데 쓰인다 . 괄호에 넣은 부분은 1 
로부터 계수된다 . 

- fileSaveAs() 

void MainForm: : fileSaveAs() 

{ 

QString filename = QFileDialog: : getSaveFileName( QString::null, 

’’Colors (*.txt)" ， this, "file save as", "Color Tool - File Save As" ); 
if ( ! filename.isEmptyO ) { 
int ans = 0; 

if ( QFile::exists( filename ) ) 

ans = QMessageBox: : waming( this, ’’Color Tool ― Overwrite File", 

QString( "OverwriteV%!'?" ) .arg( filename ), 

，， &Yes n , "&No n , QString::null, 1， 1 ); 
if ( ans == 0 ) { 
m_filename = filename; 
fileSave(); 
return; 

} 

} 

statusBar()->message( "Saving abandoned", 2000 ); 

} 

사용자가 편집하고 보관하지 않은 자료를 보관하려고 시도하거나 현존자료를 새 이 
틈으로 보관하려고 한다면 이 처리부가 호출된다 . 사용자에게 파일이름을 선택할수 있는 
표준파일대 화칸이 제 시된다 . 이 미 파일 이름이 존재하면 계속 ( 덧쓰기)하겠는가 또는 취 소 
하겠는가 하는 선택 이 주어 진다 . 파일 이 름이 존재하지 않거 나 혹은 사용자가 계속하기 로 
선택 하였 다면 m_filename 성 원 이 설 정 되 고 fileSave() 가 호출된 다 . 

- fileSave() 

void MainForm: : fileSave() 

{ 

if ( m filename .isEmpty() ) { 
fileSaveAs(); 
return; 

} 
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QFile file( m_filename ); 

if ( file.open( IO WriteOnly ) ) { 

QTextStream stream( &file ); 
if ( ! m comments.isEmptyO ) 

stream « m_comments.join( M \n M ) « "\n"; 
QMap<QString,QColor>::ConstIterator it; 

for ( It = m_colors.constBegin(); it != m_colors.constEnd(); ++it ) { 
QColor color = it.data(); 
stream « QString( "%1 %2 %3\t\t%4 M ). 
arg( color.red(), 3 ). 
arg( color.green(), 3 ). 
arg( color.blue(), 3 ). 
arg( it.key() ) « ， V，; 

} 

file.close(); 

setCaption( QString( "Color Tool — %1" ).arg( m 一 filename ) ); 
statusBar()->message( QString( "Saved %1 colors to '%2' M ). 
arg( m_colors.count() ). 
arg( m_filename )，3000 ); 
mchanged = FALSE; 

} 

else 

statusBar()->message( QString( "Failed to save ’%1’" ). 
arg( m filename), 3000 ); 


현재파일 이 름이 없 으면 fileSaveAs () 를 호출하고 사용자가 파일 이 름을 제 공하면 그 
함수는 이것을 호출한다 . 

우선 설명행을 쓴다 . 이것은 적재하고 보관한 파일이 갈지 않을수 있다는것을 의미 
한다 . (실례 로 원시파일 이 도처 에 분산되 여있는 설명 문들을 가지 고있 다면 우리 가 보관한 
판이 선두에 모든 설명을 가지게 된다 .) 그다음 m_colors 매프의 매개 색을 순환하면서 
rgb.txt 파일형식 으로 써 넣는다 . 

- fileExit() 

void MainForm: : fileExit() 
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{ 

if ( okToClear() ) { 

QApplication: : exit( 0); 

} 

} 

이것은 이 함수의 두번째 갱신이다 . 이제는 사용자가 보관하지 못한 변경을 보관할 
기회를 가지게 되였다 . (후에 이 함수의 제 3 판과 최종판을 만든다 . 이때 사용자설정의 
보관을 론한다 .) 

프로그람을 구축하고 실행한다 . 체계에 rgb.txt 가 있다면 그것을 적재해보고 시험을 목적 
으로 새로운 이름으로 보관해본다 . 이런 파일이 없다면 표준색을 보관하고 그것을 리용해본다 . 
다음에 자기의 색파일들을 생성할수 있도륵 색의 추가 및 삭제방법을 설명한다 . 

10) 편집선택코드의 편집 

새로운 색의 추가 , 탐색，사용자선택의 조종은 모두 전용대화칸을 요구하므로 그것 
들은 대화칸을 론하는 3 절에로 넘기기로 한다 . 

- editCut() 

void MainForm: : editCut() 

{ 

QString name; 

QWidget *visible = colorWidgetStack->visibleWidget(); 
statusBar()->message( QString( "Deleting ).arg( name ) ); 


if ( visible = tablePage && colorTable->numRows() ) { 
int row = colorTable->currentRow(); 
name = colorTable->text( row, 0 ); 
colorTable->removeRow( colorTable->currentRow() ); 
if ( row < colorTable->numRows() ) 
colorTable->setCurrentCell( row, 0 ); 
else if ( colorTable->numRows() ) 
colorTable->setCurrentCell( colorTable->numRows() - 1, 0 ); 
m_icons_dirty = TRUE; 

} 

else if ( visible == iconsPage && colorIconView->currentItem() ) { 
QlconViewItem *item = colorIconView->currentItem(); 
name = item->text(); 
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if ( colorlconView->count() == 1 ) 
colorlconV iew->clear(); 
else { 

QlconViewItem * current = item->nextltem(); 
if ( ! current ) 

current = item->pre vltem(); 
delete item; 
if ( current ) 

colorlconView->setCurrentItem( current ); 
colorIconView->arrangeItemsInGrid(); 

} 

mtabledirty = TRUE; 

} 


if ( ! name.isNull() ) { 
m_colors.remove( name ); 
mchanged = TRUE; 

statusBar()->message( QString( "Deleted ， %1”’ ).arg( name ), 5000 ); 

} 

else 

statusBar()->message(QString("Failed to delete '%l"').arg(name), 5000); 

} 

사용자가 표보기 를 보고있 으면 현재 행 을 삭제한다. 새 로운 현재 세 포를 삭제 된 렬 
뒤의 것 으로 설정하거 나 삭제한것 이 마지 막이면 그앞의것 으로 설정한다. 다른 보기(그림 
기호보기)를 변경된것으로 표식한다. 사용자가 보기들을 절환하면 그것이 갱신된다는것 
을 담보하기 위해서이다. 마찬가지로 사용자가 그림기호보기를 보고있으면 다음(없으면 
이 전) 항목을 현재 항목으로 만들고 항목들이 있 던 보기 를 삭제한다. 그다음 표보기 를 변 
경 된것 으로 표식한다. 색 을 삭제하였 다면(즉 보기 들중 하나에 현재 색 이 있 었 다면) 
m _ colors 매프에서 그것을 삭제 하며 자료를 변경된것으로 표식 한다. 

- editCopy() 

void MainForm: : editCopy() 

{ 

QString text; 

QWidget *visible = colorWidgetStack->visibleWidget(); 
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if ( visible = tablePage && colorTable->numRows() ) { 
int row = colorTable->currentRow(); 
text = colorTable->text( row, 0 ); 

} 

else if ( visible == iconsPage && colorIconView->currentItem() ) { 

QlconViewItem *item = colorIconView->currentItem(); 
text = item->text(); 

} 

if ( ! text.isNull() ) { 

QColor color = m 一 colors [text]; 
switch ( m_clip_as ) { 

case CLIP AS HEX: text = color.name(); break; 
case CLIP_AS_NAME: break; 
case CLIP AS RGB: 

text = QString( n %l,%2,%3 M ). 
arg( color.red() ). 
arg( color.green() ). 
arg( color.blue() ); 
break; 

} 

clipboard->setText( text ); 

statusBar()->message( "Copied + text + … to the clipboard" ); 

} 

} 

이 함수에서 현재표의 행으로부터 색이름(또는 보기에 따라 현재 그림기호)을 엄는다. 
그다음 QString 을 오려둠판에 복사하려고 하는 본문으로 설정하고 그것을 복사한다. 

이 절에서는 표준기본창문형식의 응용프로그람을 작성하였다. 그리고 차림표와 도 
구띠，기본창문부품 ( QWidgetStack ) 들을 실현하였다. 또한 신호-처리부련결을 만들고 
많은 전용처 리부들을 실현하였다. 
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제 3 절. 대화칸작성 


이 절에서는 colortool 응용프로그람을 완성하는데 필요한 대화칸들을 만든다. 앞절 
에서 생성한 모든 대화칸은 기본창문으로부터 호출된다. 모달 및 이행허용대화칸을 생성 
하고 사용하는 방법과 Qt Designer 에서 이의 배치콜라스들을 사용하여 잘 비례되는 폼 
들을 생성하는 방법을 학습한다. 

1. 색추가 

Qt 는 이미 색선택대화칸을 펼치는 정 적함수를 가지 고있다. 그러 나 색을 선택할 뿐 
아니라 거기에 이름도 주어야 한다. 실례로 사용자에게 색선택대화칸을 제공하고 색을 
선택하면 그 이름을 묻는다. 



그림 1-46. 색선택대화칸 


1) 련결의 만들기 

기본품을 생성 하였을 때 editAddAc 吐 on 이 라는 작용을 만들었다. 차림 표띠 ( Edit 차 
림표)에 이 작용을 추가하고 도구띠에도 추가하였다. 이제는 이 작용을 처리부에 련결하 
여 색을 추가하게 할수 있다. 

Edit | Connections 을 눌러서 View and Edit Connections 대화칸을 열고 New 를 
선택하여 새 련결을 생성하며 Sender 를 edit Add Ac 仕 on 로, 신호를 activated ()5., 
receiver 를 MainForm 으로 변경 한다. 련결하려는 새 처리부를 창조해야 한다. Edit 
Slots 를 선택하여 Edit Functions 대화칸을 열고 New Function 를 찰칵하고 처 리부의 
이름을 editAddO 로 변경한 다음 OK 를 찰칵한다. 이제 련결하는 처 리부를 editAddO 
로 변경한 다음 OK 를 찰칵하여 대화칸을 닫는다. 

- 창문부품의 선택 

개 별적 창문부품을 선택 하기 위 하여 창문부품자체 를 누르거 나 Object Explorer 에 서 
Name 을 찰칵한다. 그롭을 선택하려면 붉은색 륜곽선밖의 부분을 누르거나 Object 
Explorer 에서 Name 을 찰칵한다. 
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배치안에 있는 창문부품들사이의 짱에 창문부품을 삽입하려고 한다면 새 창문부품 
용의 도구띠단추를 누르고 짱안에서 마우스를 찰칵한다. Qt Designer 는 배 치를 파피 하 
려고 하는가를 묻는데 여기서 Break Layout 를 누르면 배치는 파괴되고 창문부품이 삽 
입된다. 그다음 배치 및 다시 배치하려는 창문부품과 그룹들을 선택할수 있다. 그롭을 
선택 하고 Break Layout 도구띠단추나 Ctrl + B 를 누름으로써 같은 효과를 얻 을수 있 다. 

5가지의 각이한 방법으로 여러개의 창문부품들을 선택할수 있다. 

© 첫 창문부품을 선택하고 다른 창문부품들을 Shift 를 누른 상태에서 마우스로 찰 
칵한다. 

逐) 첫 창문부품을 Ctrl 을 누른 상태에서 마우스로 누른 다음 다른 창문부품들을 
Ctrl 을 누르면서 마우스로 찰칵한다. 이것은 첫째 수법과 비슷하지만 다른 창문부품(실 
례로 그를)안에 있는 창문부품들을 선택하게 한다. 

激 폼을 선택하고 선택창을 끌면서 포함하려는 모든 창문부품들에 접근한다. 

④ 첫 창문부품을 Ctrl 를 누른 상태에서 마우스로 선택하고 선택창을 끌면서 다른 
창문부품들에 접근한다. 이것은 다른 창문부품(례하면 그를)안에 있는 창문부품들을 선 
택하게 하는 이전의 수법들과 다르다. 

⑤ Object Explorer 의 Objects 타브를 찰칵한다. Object Explorer 에서 첫 창문부 
품을 선택한 다음 다른 창문부품을 Shift 를 누른 상태에서 마우스로 찰칵한다. 이것은 
복잡한 배치가 많이 있을 때 창문부품들을 선택하는데 특히 효과있다. 

여러개의 창문부품들이 선택될 때 그 공통속성들이 Property Editor 에 표시된다. 
Property Editor 에서 이루어진 변경은 선택된 모든 창문부품들에 적용된다. 이것은 공 
통적 인 최소최대크기，색 , 크기조절방법，유표，서체 등을 설정하는데 특히 효과있다. 

2) 대화칸작성 

- 배치 

배 치 ( layout ) 는 창문부품，창문부품그를, 배 치들을 수평，수직 및 살창으로 배 치 하 
는 도구를 제공한다. 배치를 좀에 사용하면 그것이 포함하는 창문부품들은 사용자가 창 
문크기를 조절하는데 따라 자동적으로 비례하여 조절된다. 이것은 비례를 얻기 위한 코 
드를 쓰지 않으므로 절대크기와 위치를 사용하는것보다 더 좋으며 사용자들이 무릎형름 
퓨터를 가지는가 대형화면 탁상틈퓨터를 가지고있는가에 관계없이 자기 화면의 대부분을 
차지 할수 있다. 배 치는 여백과 창문부품간격 의 표준크기 를 사용하여 응용프로그람들에 
일관적 이고 비례적인 외관을 주게 한다. 또한 배치는 절대위치지정보다 사용하기 쉽고 
빠르다. 근사위 치의 폼으로 창문부품들을 배 치할수 있으며 창문부품들의 크기와 비례를 
정확히 설정하는데 배치도구를 사용한다. 

- 창문부품의 추가 

Qt 의 정적대화칸들중 하나를 사용하여 사용자가 색을 선택하게 할수 있으나 우리는 자 
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체의 대화칸을 이름을 지정하여 만들어 색을 얻게 한다. 이제 그 대화칸을 만들어보자. 

FilelNew 를 눌러서 New File 대화칸을 열고 Dialog 를 누른 다음 OK 를 찰칵한다. 
새 폼의 모서리를 끌기하여 크기를 더 작게 만든다. Property Editor 에서 종이름을 
ColorNameForm 로, 제목을 Color Tool — Color Name 으로 변경한다. File ᅵ Save 를 
누르고 Save 를 선택하여 그것을 보관한다. 

그다음 대화칸에 창문부품들을 추가한다. 위치와 크기를 정확히 지정하지 않아도 
된다. Qt Designer 는 폼을 간단히 배 치 할수 있게 한다. 

사용자가 선택한 색을 표시하는 QLabel 을 만들어야 한다. Toolbox 에서 
TextLabel 도구를 누르고 폼의 왼쪽을 선택한다. 표식의 이름속성을 colorLabel 로 변 
경하고 본문을 text 속성에서 삭제 한다. pixmap 속성의 생략단추를 누르고 edit raise , png 
화상을 선택 한다. minimumSize 속성의 wid 比 i 보조속성을 80으로, scaledContents 속성 
을 True 로 변경한다. 

TextLabel 도구를 다시 선택한 다음 colorLabel 의 오른쪽, 폼의 웃부분을 선택하 
고 text 속성을 &Name 으로 변경한다. &가 표시된다. 이것은 QLabel 이 초점을 받아들일 
수 없으며 그것은 아직 초점창문부품 ( buddy ) 을 지정하지 않았기때문이다. 

LineEdit 도구를 선택하고 Name 표식자의 오른쪽을 선택한 다음 다시 픔의 웃부분 
을 선택한다. name 속성을 colorLineEdit 로 변경한다. 

Name 표식자를 선택하고 buddy 속성을 colorLineEdit 로 변경한다. 지금 &는 표시 
되지 않고 Alt+N 은 colorLineEdit 에 초점을 설정 한다. 

PushButton 도구를 선택하고 colorLabel 아래를 찰칵한다. 단추의 이름속성을 
okPushButton 로, text 속성을 OK 로, default 속성을 True 로 변경한다. 



그림 1-47. 색선택대화칸에 창문부품들의 추가 
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PushButton 단추를 다시 선택하고 OK 단추의 오른쪽을 찰칵한다. 이 단추의 
name 속성을 cancelPushButton 으로， text 속성을 Cancel 로 변경한다. 

- 창문부품의 배 치 

이제는 필요한 창문부품들을 만들어 대체로 배치하였으므로 그것들을 정확히 배치 
할 준비가 되였다. 

창문부품배 치 과정 은 기 본적 으로 2단계 이 다. 

2개 이상의 창문부품(또는 배 치)을 선택한다. 

배 치 방법 (수직 , 수평 , 살창)을 선택 항목들에 적 용한다. 

Qt Designer 는 창문부품과 배치를 선택하는 몇가지 다른 방법을 제공한다. 그 사 
용에서 문제될것은 없으며 일부는 일정한 상황에서 다른것보다 더 편리하다. 폼을 배치 
할 때 창문부품들을 선택하는 몇 가지 방법들을 보여준다. 

Name 표식자과 행편집칸을 나란히 배치한다. 그다음 단추들도 같은 방법으로 배치 
하고 끝으로 colorLabel 과 련관된 2개를 배 치한다. 

폼을 선택하여 창문부품선택을 해제한다. Name 표식자우의 폼을 선택하고 신축할수 
있는 검 은색 장방형 을 끌기 하여 Name 표식 자과 행 편집칸에 모두 닿도록 하고 마우스를 
놓는다. (마우스를 놓을 때 그것들에 닿아야 한다.) 그러면 Name 표식자과 행편집칸이 
선택된다. Lay Out Horizontally 도구띠 단추를 찰칵한다. 배 치에 포함된 항목들이 붉은 
색 장방형안에 나타난다. (이 것 은 오직 Qt Designer 에 서 시 각적 인 암시 로서 표시 되 며 
미 리보기 방식 이 나 실행하는 종에서는 나타나지 않는다.) 



그림 1-48. Name 표식 자과 행 편집 칸의 수평 배 치 
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그림 1-49. 수평 배 치 후 Name 표식 자과 행 편 집 칸 

폼을 선택하여 창문부품선택을 해제한다. Object Explorer 의 Objects 타브에서 
cancelPushButton 을 선택한다. 이제 Objects 타브에서 Shift 를 누르면서 OK 단추를 
누르고 ( Objects 타브는 오직 한개 객체만 강조표시하지만 폼은 두개 단추가 선택된다는 
것 을 보여 준다. ) Lay Out Horizontally 도구띠 단추를 찰칵한다. 

폼을 선택 하여 창문부품선택을 해제 한다. Objects Explorer 에서 Layoutl ( Name 표식 
자과 행편집이 있다.)를 누르고 Shift 를 누르면서 Layout 2( 단추들이 있다.)를 마우스로 찰 
칵하여 폼에서 두개 배치를 선택하고 Lay Out Vertically 도구띠단추를 찰칵한다. 

이제는 2개의 배치와 colorLabel 창문부품을 얻었으며 폼과 관련하여 그것들을 배 
치한다. 

폼을 선택 하여 창문부품의 선택 을 해 제 한다. Lay Out Horizontally 도구띠 단추를 
찰칵하여 종을 배 치 한다. 



그림 1-50. 폼의 수평배치 
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폼을 미 리 보기 ( Ctrl + T ) 하고 그 크기 를 조절 한다. 폼을 더 크게 하면 단추들은 너 
무 커져서 볼품없이 된다. 더우기 단추들이 폼의 바닥에 놓이지 않는다. 문제는 종을 늘 
물 때 사용하지 않는 공간이 많으므로 단추들이 이 공간을 사용하지 않도록 하는것 이 다. 
이것은 수축자를 삽입하여 달성한다. 

수축자들을 삽입하고 폼을 다시 배 치하도록 하기 위하여 폼배치를 파괴하여야 한다. 
Layout 3 의 붉은색장방형을 선택하고 전체폼의 배치를 선택하고 (Object Explorer 에서 
배 치를 선택하여 간단히 얻을수 있다.) Break Layout 도구띠 단추를 찰칵한다. 

단추들의 왼끝에 수축자를 하나 추가하고 그것을 단추들과 배 치 할수 있으나 여유배 치창 
조를 보관하기 위하여 그대신 단추들을 포함하는 배치를 파괴하고 수축자를 가진 단일한 배 
치 로서 그것들을 배 치 한다. 단추들중 하나를 선택 하고 Break Layout (또는 Ctrl + B ) 를 누른 
다. OK 단추를 약 절반폭으로 그 왼쪽에 짱을 주어서 대충 크기를 조절한다. Toolbox 안에 
서 또는 도구띠우에서 Spacer 도구를 누르고 OK 단추왼쪽의 폼을 선택 하고 수평으로 끌기한 
다. 지금 수평수축자(푸른색 용수로 가리 킨다. )는 OK 단추의 왼쪽에 있다. 

수축자를 이미 선택하였으므로 단추들을 포함하도록 선택을 간단히 확장한다. Shift 
를 누르면서 OK 를 찰칵하고 취소단추를 찰칵하여 2개 단추와 수축자를 선택하고 Lay 
Out Horizontally (또는 Ctrl + H ) 를 누른다. 지금 수축자는 자기 위치에 있고 여유공간 
을 소비할수 있 다. 

이제는 행편집칸을 포함하는 배 치와 방금 생성한 배 치(단추들을 포함한다.)사이에 
수축자를 넣어서 그것들사이의 여유공간을 없애버릴수 있다. Spacer 도구를 선택하고 행 
편집과 단추들사이의 폼을 누르고 수직으로 끌기한다. 수축자는 이미 선택되였지만 선택 
을 확장하여 배치를 둘다 포함해야 한다. Object Explorer 의 Objects 타브에서 Shift 건 
을 누르면서 배 치들을 찰칵하고 Lay Out Vertically (또는 Ctrl + L ) 을 누른다. 

그러면 종자체를 배치하자. 픔을 선택하여 창문부품이나 배치들의 선택을 해제 한다. 
그다음 Lay Out Horizontally 를 찰칵한다. 



그림 ᄂ사. 수축자들의 추가 
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지금까지는 폼이 이 전과 크게 차이 나지 않았다. 폼을 미 리보기 ( Ctrl + T ) 하고 크기 
를 조절한다. 폼을 작게 하든 크게 하든 문제 는 없고 언제 나 잘 비 례 되 여있 다. 

이것이 바로 고정크기보다 배치를 리용하는것의 우점이다. 프로그람이 각이한 언어 
로 번역된다면 어떤 코드도 작성함이 없이 표식자의 크기를 자동적으로 비례되게 조절하 
므로 특별히 효과있다. 그리고 사용자들은 거대한 탁상화면으로부터 작은 무릎형화면에 
이르기까지의 넓은 범위의 화면크기에 사용할수 있다. (필요하다면 고정크기와 위치를 
사용할수 있다.) 

Qt Designer 에서 폼크기를 조절한다. 폼은 최소크기를 가진다. 이것은 폼이 포함 
하는 모든 창문부품들이 최소크기를 가지기때 문이 다. (필요하다면 최소크기 를 재정의 할 
수 있다.) Qt Designer 에서 폼을 만드는 크기는 폼의 기정크기 이 다. 

폼을 미 리 보기할 때 타브순서 가 정 확한 경 우에 Tab 를 눌러 서 초점 을 받아들이 는 
창문부품들사이를 이동할수 있다. 타브순서가 정확하지 않으면 간단히 변경할수 있다. 

- 타브순서의 변경 

건반사용자들은 Tab 건을 눌러서 폼우의 창문부품들사이로 초점을 이동한다. 초점 
이 이동하는 순서를 타브순서라고 한다. 

폼의 타브순서를 변경하려면 Tab Order 도구띠단추를 찰칵한다. 이것은 Qt 
Designer 를 타브순서방식에 넣는다. 푸른색원안의 수값이 초점을 받아들일수 있는 매개 
창문부품옆에 나타난다. 

타브순서를 변경하려면 초점을 받아들이는 순서로 각 창문부품들을 선택한다. 모든 
창문부품들이 정 확한 타브순서 를 가지 면 중지 한다. Esc 를 눌러서 타브순서방식 을 끝낸 
다. 미 리 보기 ( Ctrl + T ) 하고 Tab 건을 누름으로써 타브순서 를 시 험 할수 있 다. 

이전의 타브순서가 요구되면 EditlUndo (또는 Ctrl + Z ) 를 누른다. 



그림 1-52. 타브순서설정 
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- 창문부품의 련결 

2개의 단추 즉 OK 단추와 Cancel 단추를 조종해 야 한다. 사용자가 OK 를 찰칵하면 
색이 름이 비 여있지 않는 경 우와 이 미 사용중에 있지 않는 경 우 색이 름만 받아들인다. 
(rgb.txt 형식은 색의 중복을 허용하지만 그것들을 추가하지 않도록 선택한다.) 사용자가 
Cancel 을 누르면 대화칸을 닫는다. 

Ctrl+T 를 눌러서 폼을 미리보기한다. Cancel 단추를 누르면 아무일도 하지 않는다. 

제일 간단한 Cancel 단추부터 련결 한다. Edit | Connections 를 눌러서 View and 
Edit Connections 대화칸을 열고 New 를 눌러서 새 련결을 생성 한다. Sender 를 
cancelPushButton 로， Signal 를 clickedO 로， Receiver 를 ColorNameForm 로, 처 리 
부를 reject 0로 설정한다. 이 기능은 미리 정의된 신호와 미리 정의된 처리부를 사용하 
여 신호-처리부련결을 통하여 얻어지므로 미리보기방식에서 작업한다. OK 를 찰칵하여 
대화칸을 닫은 다음 Ctrl+T 를 눌러 미리보기한다. Cancel 단추를 찰칵하면 미리보기방 
식에서도 폼이 닫겨진다. 

이제는 OK 단추를 련결 한다. Edit | Connections 를 눌러서 View and Edit 
Connections 대화칸을 열고 New 를 눌러서 새 련결을 생성 한다. Sender 를 
okPushButton 로， Signal 를 clickedO , Receiver 를 ColorNameForm 로 설정한다. 사 
용자의 입력을 확증할수 있도록 자체의 전용처리부를 호출하려고 한다. Edit Slots 를 눌 
러서 Edit Functions 대화칸을 펼친 다. New Function 을 선택하고 함수이름을 
validateO 로 변경하고 OK 를 찰칵한다. 수신기의 처리부를 새로 생성한 validateO 처 
리부로 설정 한다. OK 를 찰칵하여 대화칸을 닫는다. 

-대화칸코드작성 

validateO 전용처 리부의 코드를 작성해 야 한다. 이 처 리부는 입력한 색 이름이 이미 
존재 하는가 확인하기 위 하여 검사하므로 색이 름들의 픔대 역목록을 설정 할수 있는 함수를 
제공해 야 한다. 

Project Overview 창문에서 colornameform.ui.h 를 누르고 코드편집기를 호출한 
다. 편집 기는 하나의 빈 처 리부 validateO 를 보여준다. 

머 리 부파일 들과 함께 색이 름들을 보관하는 폼대 역 변수를 추가해 야 한다. 기 본좀에 
대 하여 수행 한것과 같은 방법 으로 Objects Explorer 의 Members 목록에서 적 당한 부분 
을 오른쪽 단추로 찰칵하고 이 정보를 추가할수 있다. 그대신에 다른 수법으로 폼에 직 
접 필요한것을 추가한다. 필요하다면 두 수법을 리용할수 있다. 

- 성 원추가와 .ui.h 코드작성 

Object Explorer 의 Members 타브에서 Includes (in Implementation) 에 머리부 
를 추가하는 수법 과 .ui.h 파일 에 직 접 머 리 부를 입 력하는 수법 사이 에 차이 가 없 다. 

상황은 변수들에 따라 다르다. 이것들을 Members, Class Variables 에 추가하면 
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클라스정 의 에 비 공개변수로서 포함된 다. . ui . h 파일의 꼭대 기 에 그것 들을 입 력하면 폼대 역 
변수로 된다. 

다음과 같이 머 리부를 추가한다. 

#include < qcolor . h > 

#include < qmap . h > 

#include < qstring . h > 

validate () 함수우에 우의 행 들을 입 력한다. 

또한 색목록을 보관하는 변수가 요구된다. 

QMap < QString ， QColor > m _ colors ; 

이 행 을 추가하고 국부 m _ colors 매 프에 색들을 보관한다. 

또한 호출자가 현재 색 을 가진 m _ colors 매 프를 구성 하기 위 하여 호출할수 있는 함수 
를 요구한다. 

void ColorNameForm :: setColors ( const QMap < QString , QColor >& colors ) 

{ 

m_colors = colors ; 

} 

이제 는 색이 름목록을 얻는 수단이 있으므로 V alidate () 함수를 작성해보자. 
void ColorNameForm : : validate () 

{ 

Q String name = colorLineEdit -> text (); 

if (! name . isEmpty () && ( m _ colors . isEmpty () || ! m _ colors . contains ( name )) ) 
accept (); 

else 

colorLineEdit -> selectAll (); 

} 

함수는 사용자가 입력한 본문을 시험한다. 무엇인가 입력하였는데 그것 이 색목록에 
존재하지 않으면 accept () 를 호출한다. 이것은 폼을 닫고 호출측에 true 값을 돌려 준다. 
( rejecto 는 사용자가 Cancel 을 누르면 호출되며 false 값을 돌려준다.) 이미 색 이 있으면 
단지 그것 을 선택하거 나 통보창문을 펼 칠수 있 다. 

이제 는 대 화칸이 완성되 였다. 다음 단계는 editAddO 처 리부의 코드를 작성하여 기 본 
몸으로부터 그것을 사용하게 하는것 이 다. 

3) 대화칸리용 

ColorNameForm 대화칸은 기본폼으로부터 호출된다. 호출자는 우선 (교의 색선택 
정적대화칸을 호출하고 사용자가 색을 선택하면 ColorNameForm 전용대화칸을 호출한 
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다. 색선택대화칸을 사용하려고 하므로 적당한 머리부파일을 요구한다. 또한 대화칸의 
colorLabel (그것을 선택된 색으로 설정하기 위하여)과 대화칸의 행편집(색 이름을 얻기 
위 하여)을 호출하므로 이것들에 해 당한 머 리부들도 요구한다. 

Project Overview 창문에서 MainForm 을 찰칵하면 Object Explorer 는 기본폼의 
객체들을 표시한다. 

Object Explorer 의 Members 타브를 선택한다. Includes (in Implementation ) 
를 오른쪽 단추로 선택하고 Edit 를 눌러서 Edit Includes (in Implementation ) 대화칸을 
연다. Add 를 누른 다음 qcolordialog.h 라고 입력한다. 다시 Add 를 선택하고 
qlabel.h 라고 입력한다. 마찬가지로 qlineedit.h 를 추가한다. 또한 방금 생성한 픔용 
의 머리부를 포함해야 하므로 colornameform.h 를 추가하고 Enter 를 누른다. 다음 
Close 를 찰칵한다. 

이제는 머리부(실현에서)들에 다음의 선언들을 추가한다. 

•"qcolordialog.h" 

•"qlabelh" 

•"qlineedit.h" 

• "colornameform.h’’ 

editAdd () 처 리부의 코드를 입력 할 준비가 되였다. Project Overview 에서 

mainform . ui.h 를 선택 하여 코드편집기를 호출한다. 

- editAdd() 

void MainForm: : editAdd() 

{ 

QColor color = white; 

if ( ! m_colors.isEmpty() ) { 

Q Widget * visible = colorWidgetStack->visibleWidget(); 
if ( visible == tablePage ) 
color=colorT able->text(colorT able->currentRow(), 

colorTable->currentColumn()); 

else 

color = colorlconV ie w->currentltem()->text(); 

} 

color = QColorDialog::getColor( color, this ); 

if ( color . isValid () ) { 

QPixmap pixmap( 80, 10 ); 
pixmap.fill( color ); 
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ColorNameForm *colorForm = new ColorNameForm(this,"color",TRUE); 
colorForm->setColors( m_colors ); 
colorForm->colorLabel->setPixmap( pixmap ); 
if ( colorForm->exec() ) { 

QString name = colorForm->colorLineEdit->text(); 
m_colors [name] = color; 

QPixmap pixmap( 22, 22 ); 

pixmap.fill( color ); 

int row = colorTable->currentRow(); 

colorTable->insertRows( row, 1 ); 

colorTable->setText( row, COL 一 NAME, name ); 

colorTable->setPixmap( row, COL NAME, pixmap ); 

colorTable->setText( row, COL HEX, color.name().upper() ); 

if ( m show web ) { 

QCheckTableltem *item = new QCheckTableltem( colorTable, ); 
item->setChecked( isWebColor( color ) ); 
colorTable->setltem( row, COL WEB, item ); 

} 

colorTable->setCurrentCell( row, 0 ); 

(void) new QIconViewItem( colorlconView, name, colorSwatch( color ) ); 
mchanged = TRUE; 



이 함수의 코드는 아주 길지만 리해하기 힘들지 않다. 기정색을 흰색으로 설정하는 
것 으로 시 작한다. m _ colors 매 프에 색들이 있으면 기정색 을 현재보기 에 보여주는 현재색 으 
로 설정한다. 그다음 Qt-Sl 정적 getColorO 대화칸을 호출하고 거기에 기정색을 넘긴다. 
(사용자가 취소하면 무효색 이 돌아온다.) 

사용자가 색 을 선택하면 전용대 화칸에 선택한 색 을 보여 주려 고 하므로 픽 스매 프를 
생성하고 그것을 선택된 색으로 채운다. ColorNameForm 의 실례를 이행금지대화칸(셋 
째 인수는 TRUE ) 로 생 성한다. 그다음 setColorsO 함수를 호출하여 ( validate () 함수가 정 확 
히 작업 하도록) m _ colors 매 프에 색들을 설정 한다. colorLabel 의 픽 스매 프를 방금 창조한 
픽 스매 프 즉 사용자의 선택 색 으로 된 장방형 으로 설정한다. 

대화칸을 실행 ( execO ) 한다. 사용자가 OK 를 찰칵하면(그리고 입력한 색이름이 유효 
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이면) 호출은 true 값을 돌려준다. 이 경우에 행편집으로부터 입력한 이름을 얻어서 사 
용자가 준 이 름과 선택 한 색 을 리용하여 m _ colors 매 프에 새 항목을 창조한다. 

이 시점에서 보기들을 간단히 변경된것으로서 표식하고 repopulateO 을 호출할 대 
신 매개 보기에 직접 새 색을 추가함으로써 완전갱신으로 인한 추가비를 절약한다. (수 
천개 의 색 이 있으면 고려할만하다. ) 

픽스매 프를 창조하고 그것 을 새 로운 색 으로 채 운 다음 populate )：) 함수에서 와 같은 방법 으 
로 표에 새로운 행을 삽입하고 새로운 색값으로 렬을 설정한다. 마찬가지로 그림기호보기용 
의 새로운 그림기호를 창조한다. 끝으로 자료를 변경된것으로 표식하여 사용자가 이것을 보 
관하지 않고 완료하거 나 다른 색파일을 적재 하려 고 하면 보관하겠는가를 묻게 한다. 

응용프로그람의 건설，실행한다. 이제는 자체의 색을 추가할수 있다. 

응용프로그람은 기본적 으로 완성되 였다. 색파일을 적재 하고 보관할수 있고 그것들을 표 
보기나 그림기호보기에 표시할수 있으며 사용자는 색들을 추가삭제할수 있다. 그러나 사용 
자가 수백수천개의 색을 가지고있으면 특정색을 찾는데 품이 든다. 또한 사용자가 응용프로 
그람을 실행할 때는 항상 기정창문크기，보기, 기타 설정으로 기동한다. 사용자가 응용프로 
그람을 어떻게 완료하였는가를 기억하고 그 선택을 재생하면 훨씬 더 좋다. 다음의 2개 소 
절에서 비모달탐색대화칸와 모달선택대화칸의 창조를 통하여 이 문제를 고찰한다. 

2. 색탐색 

이 선택수법은 색추가와 비슷하다. 대화칸을 만들고 련결을 만들고 코드를 쓰고 그 
것을 호출하는 처리부의 코드를 작성한다. (이미 기본폼에서 설정된 련결을 가지고있는 
데 그것은 기본창문위 자드에 의하여 자동적으로 창조되 였다.) 



그림 1-53. 색람색대화칸 

1) 대화칸작성 

FilelNew 를 선택하여 New File 대화칸을 열고 Dialog 를 선택하고 OK 를 찰칵한다. 
픔의 모서 리를 골어서 픔을 작게 만든다. Property Editor 를 사용하여 몸의 name 속성 
을 F 比 idForm 로, caption 속성을 "Color Tool — Find Color " 로 변경한다. 

폼을 보관하기 위하여 Ctrl + S (혹은 FilelSave ) 를 선택하고 Save 를 찰칵한다. 

- 창문부품의 추가 

Toolbox 에서 TextLabel 도구를 선택하고 폼의 왼쪽을 선택한다. text 속성을 
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"&Look for ” 로 변경한다. (& 는 Alt + L 지름건을 위한 초점창문부품 buddy 를 아직 제공 
하지 않았으므로 폼에 표시된다.) 

LineEdit 도구를 선택하고 폼우에서 Look for 표식 자의 오른쪽을 선택하고 name 속 
성 을 findLineEdit 로 변경 한다. Look for 표식 자를 누르고 buddy 속성 을 findLineEdit 
로 변경한다. 

PushButton 도구를 선택 하고 좀에서 행 편집아래를 선택 한다. name 속성을 
findPushButton 로, text 속성을 SFind 로, default 속성을 True 로 변경한다. 

PushButton 도구를 다시 선택하고 폼우에서 Find 단추의 오른쪽을 찰칵한다. name 
속성을 closePushButton 로， text 속성을 Close 로 변경한다. 

단추들우에 그리고 단추들의 왼쪽에 수축자를 요구하는 이전 폼을 가지고 실험하여 
본다. Spacer 도구를 선택하고 Find 단추의 왼쪽을 선택하고 좀 오른쪽으로 수평으로 끌 
고가서 놓는다. Spacer 도구를 다시 선택하고 Find 단추우를 누르고 수직으로 좀 끌고가 
서 놓는다. 



그림 1-54. 창문부품들의 추가 

- 창문부품의 배 치 

창문부품들을 창조하고 대충 배치하였으므로 이제는 그것들을 배치하여야 한다. 

폼을 선택하여 창문부품의 선택을 해제한다. Close 단추의 오른쪽 아래를 선택하고 
선택창을 2개의 단추와 수축자에 달도록 Find 단추의 왼쪽으로 끌고가서 놓는다. 너무 
정확하지 않아도 된다. 오직 우리가 관심을 가지는 3개의 항목들에 이르기만하면 된다. 
잘못하여 아무것도 선택되지 않거나 다른것을 선택하였다면 폼을 선택하고 다시 시도한 
다. 일단 수축자 ( Find 단추의 왼쪽에)와 두 단추가 선택되면 Lay Out Horizontally 도 
구띠단추를 찰칵한다. 

Look for 표식자과 행편집칸을 수평으로 배치한다. (Look for 표식자를 선택하고 
Shift 를 누른 상태에서 행편집을 마우스로 선택하고 Ctrl + H 를 누른다.) 

이제는 종자체를 배치할수 있다. 품을 선택하고 Ctrl + L (수직배치)을 누른다. 폼의 
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크기 를 약간 조절 하여 더 작게 할수 있 다. 폼을 미 리 보기 ( Ctrl + T ) 하고 크기 를 조절 한 
다음 보기 좋은가 확인한다. 



그림 1-55. 폼의 배치 

- 창문부품의 련결 

탐색대화칸을 만드는 2가지 수법이 있다. 하나는 이행금지대화칸을 사용하는 수법 
으로서 사용자가 단어를 입력하고 Find 를 누르고 람색한 항목을 강조표시하고 폼을 닫 
는다. 다른 하나는 이행허용대화칸을 사용하는 수법으로서 흔히 하는것처럼 사용자가 단 
어를 입력하고 Find 을 누를 때마다 다음으로 일치하는 단어를 발견한다. 여기서는 둘째 
수법을 사용한다. 

기본폼에 보관된 자료를 통하여 탐색을 진행하고 발견한 단어를 기본폼에서 강조표 
시하려고 하므로 대부분의 람색코드를 기본폼에 넣는다. 이것을 달성하려면 사용자가 
Find 단추를 누를 때마다 FindForm 에 신호를 발송하여 일치하는 색을 발견하지 못했다 
는것을 FindForm 에 통지하기 위하여 기본좀이 호출하는 처리부를 제공한다. 

•View and Edit Connections 대화칸을 펼친 다. ( Edit | Connections 을 찰칵한다.) 

■ closePushBu 竹 on 의 clickedO 신호를 폼의 acceptO 처리부와 련결한다. ( New 를 
누르고 Sender 를 closePushButton 로, Signal 을 clickedO 로, 종을 FindForm 로, 처 
리부를 acceptO 로 변경한다.) 이 기능은 순수 신호-처리부련결을 통하여 얻어지므로 
미 리보기 방식 에서 작업한다. 즉 미 리보기 하고 Close 단추를 찰칵하면 폼은 닫긴다. 

• findPushButton 의 clickedO 신호를 새 로 창조한 find () 처 리 부로 변경한다. ( New 를 
누르고 Sender 를 findPushButton 으로, Signal 를 clickedO 로, 픔을 FindForm 으로 
변경한다. Edit Slots 를 눌러서 Edit Func 仕 ons 대화칸을 펼치고 처리부이름을 findO 
로 변경 하고 OK 를 찰칵한다. View and Edit Connections 대화칸로 돌아와서 처 리부를 
새로 창조한 findO 처러부로 변경한다.) 

•View and Edit Connections 대화칸을 닫는다. ( OK 를 찰칵한다.) 

■사용자가 Find 단추를 누를 때 기본몸이 본문을 찾을수 있도록 신호를 발생한다. 

•Object Explorer 의 Members 타브를 선택하고 Signals 을 오른쪽 단추로 찰칵하고 
New 를 누르고 lookfor(const QStringS ) 라고 입력한다. fmd () 처리부용 코드를 실현할 
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때 이 신호를 발생한다. 

-대화칸코드작성 

Project Overview 에서 findform . ui . h 을 선택 하여 코드편집기를 연다. find () 함수 
를 실현하고 호출자가 람색이 실패하였다는것을 알리는데 사용하는 notfound 함수를 실 
현 한다. 

void FindForm: : find() 

{ 

emit lookfor( findLineEdit->text() ); 

} 

사용자가 Find 단추를 누를 때 행편집 에 있는 본문을 발생한다. 호출자에 따라서 이 
신호와 련결하고 탐색을 처리한다. 
void FindForm: : notfound() 

{ 

findLineEdit->selectAll() ; 

} 

단어를 전혀 찾지 못하면 본문을 강조표시하고 그렇지 않으면 통보창문을 펼처야 

한다. 

대화칸의 코드는 기본픔에 모든 작업을 포함시키므로 간단하다. 

2) 대화칸리용 

사용자가 응용프로그람에서 Edit | Find 를 선택하면 FindForm 대화칸을 열고 Find 
단추를 누를 때마다 현재 보기에서 입력한 본문을 현재 작업중에 있던 색의 뒤에 있는 
색으로부터 시작하여 탐색한다. FindForm 의 바로 하나의 실례를 생성하고 그것에로의 
지 적 자를 보유함으로써 필요할 때 그것 을 표시 하고 은폐할수 있 다. 

FindForm 를 포함하고 init () 함수에 (설명문으로) 넣은 findForm 변수를 선언한다. 
Project Overview 에서 mainform . ui . h 를 찰칵한다. 이때 코드편집기가 열리고 
Object Explorer 를 MainForm 안의 객체들을 표시 하도록 설정 한다. 

Includes (in Declaration ) 에 findform . 노를 추가한다. (Object Explorer 의 
Members 타브를 선택 하고 Includes (in Declaration ) 를 오른쪽 단추로 찰칵하고 New 
를 누르고 findform . h 라고 입력한 다음 Enter 를 누른다.) 

이제는 선언의 머리부에 다음의 선언을 추가한다. 

" findform . h " 

콜라스변수에 FindForm * findForm ; 을 추가한다. (Class Variables 를 오른쪽 단 
추로 선택하고 Edit 를 누르고 Add 를 찰칵한다. FindForm * findForm ;라고 입력하고 
OK 를 찰칵한다.) 
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다음으로 클라스변수에 다음의 변수를 추가한다. 

FindForm * findform ； 

init() 함수에 서 행 findForm = 0; 의 설 명 을 해 제 한다. 

이제는 editFind() 처리부를 실현할수 있다. 

- editFind() 

void MainForm: : editFind() 

{ 

if ( ! findForm ) { 

findForm = new FindForm( this ); 
connect( findForm, SIGNAL( lookfor(const QString&) ), 
this, SLOT( lookfor(const QString&) ) ); 

} 

findForm->show(); 

} 

FindForm 을 생성하지 않았다면 그것을 생성하고 lookfor () 신호를 기본폼에서 창조 
한 대응하는 lookfor () 처리부와 련결한다. 그다음 FindForm 을 표시하여 사용자가 탐색 
본문을 입력하고 탐색을 시작한다. 

- lookfor() 

void MainForm: :lookfor( const QString& text ) 

{ 

if ( text.isEmpty() ) 
return; 

QString ltext = text.lower(); 

Q Widget * visible = colorW idgetStack->visibleW idget(); 
bool found = FALSE; 


if ( visible = tablePage && colorTable->numRows() ) { 
int row = colorTable->currentRow(); 
for ( int i = row + 1; i < colorTable->numRows(); ++i ) 
if ( colorTable->text( i, 0 ).lower().contains( ltext ) ) { 
colorTable->setCurrentCell( i, 0 ); 
colorTable->clearSelection(); 
colorTable->selectRow( i ); 
found = TRUE; 
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break; 


if ( ! found ) 

colorTable->setCurrentCell( row, 0 ); 

} 

else if ( visible == iconsPage ) { 

QlconViewItem * start = colorIconView->currentItem(); 

for(QIconViewltem *item = start->nextltem(); item; item = item->nextltem()) 
if ( item->text().lower().contains( ltext ) ) { 
colorlconView->setCurrentItem( item ); 
colorlconView->ensureItemVisible( item ); 
found = TRUE; 
break; 

} 

if ( ! found && start ) 

colorlconView->setCurrentItem( start ); 

} 

if ( ! found ) { 

statusBar()->message( QS 仕 ing( "Could not find '%V after here").arg( text)); 
findForm->notfound(); 

} 

} 

이 처 리부는 사용자가 FindForm 에서 Find 단추를 찰칵할 때 호출된다. FindForm 
의 행편집 에 사용자가 입력한 본문은 text 파라메 터로서 넘긴다. 본문이 없으면 단순히 되 
돌아간다. 

대소문자구별하여 탐색하려고 하므로 본문의 소문자사본을 가전다. 사용자가 어느 
보기 를 리용하고있는가 알아보고 found 기 발을 설정 하고 후에 그 기 발을 사용한다. 

사용자가 표보기를 사용한다면 현재 작업하고있는 행의 다음행부터 탐색을 시작한 
다. 일 치하는 본문을 찾으면 그것 을 포함하는 행 을 선택 하고 found 를 TRUE 로 설정하 
고 탐색 을 중지한다. 일 치하는 본문을 찾지 못하면 현재 세 포를 탐색 을 시 작한 세 포뒤 로 
설 정 한다. 

사용자가 그림기 호보기 를 사용한다면 현재 항목의 다음 항목부터 람색 을 시 작한다. 
일치하는 본문을 찾으면 대응하는 항목을 선택하고 그것을 볼수 있게 한다. 다시 일치하 
는 본문을 찾지 못하면 현재 항목을 탐색 을 시 작한 항목으로 설 정한다. 
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본문을 발견하면 관련항목은 선택되였으므로 사용자의 보기에서 강조표시된다. 본 
문을 발견하지 못하면 상태띠에 통보를 표시하고 FindForm 의 (탐색본문을 단지 선택하 
는) notfound () 함수를 호출한다. 

코드편집 기 에 직 접 입 력 한 함수들은 (그것 들이 공개처 리 부로 되 는 경 우에 돌림값이 
void 아니 면) 공개 함수로 된다. 이 것 들은 후에 함수속성 을 편집하여 변경할수 있 다. 
lookfor () 는 그것과 련결해야 하므로 처리부로 되여야 한다. Object Explorer 의 
Members 타브를 선택하고 lookfor () 를 오른쪽 단추로 찰칵하고 Properties 를 찰칵한다. 
이것은 Edit Functions 대화칸을 연다. Type 를 slot 로 변경하고 OK 를 찰칵한다. 

응용프로그람을 보존 ( Ctrl + S ) 하고 건설하고 람색을 시도해본다. 

3. 사용자선택 

표보기에서 웨브색 인가를 가리키는 선택과 Ctrl + C 를 눌러 색을 복사할 때 오려둠판 
에 복사하는 선택을 사용자에게 주려고 한다. 또한 보기，창문크기，위치를 자동적으로 
보존하고 되살리려고 한다. 



그림 1-56. 색속성설정도구 

1) 대화칸작성 

새 대화칸을 창조한다. (File | New 를 눌러서 New File 대화칸을 열고 Dialog 를 선 
택 하고 OK 를 찰칵한다.) 폼의 name 속성을 OptionsForm 으로, cap 社 on 속성을 "Color 
Tool — Options " 로 변경한다. 폼의 모서리를 끌어서 폼을 좀 작게 만든다. 이제 종을 
보관하고 기정값을 받아들인다. 

Containers 도구칸에서 GroupBox 도구를 선택하고 픔의 왼쪽웃부분을 찰칵한다. 
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그롭칸을 끌기하여 그 폭을 늘인다. title 속성을 Table View 로 변경한다. 

Common Widgets 도구칸에서 CheckBox 도구를 선택하고 그룹칸안을 찰칵한다. 검 
사칸의 name 을 webCheckBox 로， text 속성을 Indicate &Web Colors 로， checked 속 
성을 True 로 변경한다. 

지금까지는 항상 모든 창문부품들을 배치하고 그것을 배치하였다. 그러나 여기서는 
창문부품들을 배치하면서 배치한다. 그룹칸을 선택하고 Ctrl + H (수평배치)를 누른다. 



그림 1-57. 검사칸의 추가 

ButtonGroup 도구를 선택하고 표보기그룹칸아래를 찰칵한다. 그룹의 title 속성을 
Copy to Clipboard As 로 변경하고 모서 리를 끌기 하여 더 크게 만든다. 

오려둠판그룹에 3개의 라지오단추를 추가하려고 한다. 여러개의 같은 창문부품들을 
추가할 때 Qt Designer 의 다중배 치 방식을 사용하여 더 빨리 작업 할수 있다. 

RadioButton 도구를 련속 두번 찰칵하여 다중배치방식에 들어간다. 그러면 폼을 
누를 때마다 라지오단추가 하나씩 생성된다. 오려둠판그룹칸의 안과 우를 찰칵한다. 첫 
라지오단추아래를 찰칵한다. 세번째로 둘째 라지오단추의 아래를 찰칵한다. Pointer 도 
구띠단추를 찰칵하여 다중배 치 방식 을 퀴 소한다. 
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■ Color Tool- Options 


B 因田 


- Table View —— 

W Indicate Web Colors 


- Copy to Clipboard As 
( RadioButtonl. 

C RadioButton2 


C RadioButton3 


그림 1-58. 라지오단추의 추가 

첫째(제 일 우에 있는) 라지오단추를 찰칵하고 name 속성을 hexRadioButton 로, 
text 속성을 & Hex , e . g . # AB 52 F 7 로， checked 속성을 True 로 변경한다. 

둘째 (중간) 라지 오단추를 찰칵하고 name 속성 을 nameRadioButton 로，본문을 
技 Name , e . g . light blue 로 변경한다. 

셋째(아래) 라지오단추를 찰칵하고 name 속성을 rgbRadioButton 로， 본문을 
& RGB , e . g . 51，255,102로 변경한다. 

오려둠판그롭을 선택 하고 Ctrl + L (수직배 치)를 누른다. 
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그림 1-59. 오려둠판그룹의 수직배치 

이제는 OK 단추와 Cancel 단추를 생성한다. ( PushButton 도구를 선택하고 오려둠 
판그를아래의 폼을 찰칵한다. 단추의 이름을 okPushButton 로, text 를 OK 로, default 
속성을 True 로 설정한다. PushButton 도구를 다시 선택하고 OK 단추의 오른쪽을 찰칵 
한다. 단추의 이 름을 cancelPushButton 으로, 본문을 Cancel 로 변경 한다. ) 

단추들을 배 치하기 위하여 OK 단추의 왼쪽에 수평수축자를 추가하여 수축자와 단추 
들을 수평으로 배 치한다. ( Spacer 도구를 선택하고 OK 단추의 왼쪽의 폼을 누르고 좀 왼 
쪽으로 수평으로 끌고가서 놓는다. Shift 를 누른 상태 에서 OK 단추를 누르고 Shift 를 누 
른 상태에서 Cancel 단추를 찰칵한다. Ctrl + H 를 누른다.) 
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B 因田 


- Table View — 

W Indicate Web Colors 


- Copy to Clipboard As - 

C Hex, e.g. #AB52F7 
C Name, e.g. light blue 
r RGB, e.g. 51,255,102 



H 

OK 

Cancel | 


그림 1-60. 단추와 수평수축자의 추가 

종을 배 치 한다. (폼을 선택 하고 Ctrl + L 을 눌러 수직 으로 배 치한다. ) 폼의 크기 를 
조절하여 적당한 크기와 모양으로 만든다. 



- Table View —— 

W Indicate Web Colors 


- Copy to Clipboard As —— 
C Hex, e.g. #ABS2F7 
C Name, e.g. light blue 
r RGB, e.g. 51,255,102 



""""""""//""""""서 

OK 

Cancel 


그림 1-61. 폼의 수직배 치 
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- 창문부품의 련결 

options 대화칸은 전통적인 대화칸로서 호출자는 그것을 창조하고 창문부품들을 설 
정하고 사용자가 OK 를 찰칵하면 품의 창문부품들로부터 자료를 읽어들이고 동작한다. 
해야 할 작업은 OK 와 Cancel 단추를 련결하는것 이다. 코드를 쓸 필요는 없다. 

◦ K 단추를 픔의 acceptO 처리부에, Cancel 단추를 픔의 reject() 처리부에 련결한다. 
( Edit | Connections 를 선택하고 New 를 찰칵하고 Sender 를 okPushButton 으로， 
Signal 을 clicked ()5-, Receiver 를 OptionsForm 으로，처리부를 acceptO 로 변경한다. 
다시 New 를 찰칵하고 Sender 를 cancelPushButton 으로, Signal 을 clickedO 로, 
Receiver 를 OptionsForm 으로，처리부를 rejectO 로 변경한다. OK 를 찰칵하여 련결대 
화칸을 닫는다.) 

2) 대화칸의 리용 

Project Overview 에서 mainform . ui.h 를 눌러서 코드편집기를 호출하고 

MainForm 을 Qt Designer 의 현재품으로 설정한다. 

options 폼을 호출하는 처리부를 창조하고 이 처리부에 optionsAction 작용을 련결 
해 야 한다. 

View and Edit Connections 대화칸을 열고 optionsAction 으로부터 editOptions 
라는 새 처리부에로의 새 련결을 창조한다. ( Edit | Connections 를 선택하고 New 를 찰 
칵한다. Sender 를 optionsAction 로， Signal 를 activated 0^-, Receiver 를 MainForm 
으로 변경한다. Edit Slots 단추를 찰칵하여 Edit Functions 대화칸을 연다. New 
Function 을 누르고 처리부의 이름을 editOptions 0로 변경하고 OK 를 찰칵한다. Slot 
함수를 새로 창조한 editOptions 0처 리부로 만든다. OK 를 찰칵한다.) 

이제는 처리부의 코드를 작성할 준비가 되였다. 

- editOptions() 

void MainForm: : editOptions() 

{ 

OptionsForm ^options = new OptionsForm( this, "options", TRUE ); 
switch ( m clip as ) { 
case CLIP_AS_HEX: 

options->hexRadioButton->setChecked( TRUE ); 
break; 

case CLIP_AS_NAME: 

options->nameRadioButton->setChecked( TRUE ); 
break; 

case CLIP AS RGB: 
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options->rgbRadioButton->setChecked( TRUE ); 
break; 


options->webCheckBox->setChecked( m show web ); 


if ( options->exec() ) { 
if ( options->hexRadioButton->isChecked() ) 
m_clip_as = CLIP_AS_HEX; 
else if ( options->nameRadioButton->isChecked() ) 
m_clip_as 욕 CLIP_AS_NAME; 
else if ( options->rgbRadioButton->isChecked() ) 
m_clip_as = CLIP_AS_RGB; 
m table dirty = m show web != 

options->webCheckBox->isChecked(); 
mshowweb = options->webCheckBox->isChecked(); 

populate(); 

} 

} 

새로운 선택픔을 창조하고 거기에 TRUE 를 넘기여 모달로 만든다. m_clip_as 변수의 
현재 설정 에 따라 라지 오단추를 설정한다. m_show_web 변수와 대 응되 게 검사칸을 설정한다. 
픔을 실행하고 사용자가 OK 를 찰칵하면 그 선택을 련관된 기본픔변수들에 반영한다. 사 
용자가 webCheckBox 를 눌러서 m_show_web 변수를 변경하면 갱신을 요구하므로 표를 변 
경된것 으로 표식 한다. 그다음 필요하다면 표보기 를 갱 신하는 populate() 를 호출한다. 

◦ptionsForm 을 사용하여 그 라지오단추와 검사칸을 호출하므로 실현의 머리부들 
에 optionsform.h 와 qradiobutton , h , ^ checkbox , h 를 추가해야 한다. (Object 
Explorer 의 Members 타브를 선택하고 Includes(in Implementation ) 를 오른쪽 단추 
로 누른 다음 Edit 를 찰칵한다. Add 를 누르고 optionsform.h 라고 입력하고 다시 Add 
를 누르고 qradiobutton.h 라고 입력 한다. 다시 Add 를 누르고 qcheckbox . h 라고 입 
력한다. Enter 를 누른 다음 Close 를 선택한다.) 

실현의 머리부들에는 다음의 선언들이 추가되여있다. 

" optionsform . h ” 

" qcheckbox . h M 
" q radiobutton , h " 
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그러면 사용자는 자기 기호에 맞게 선택을 변경할수 있다. 그러나 이 선택설정은 
응용프로그람을 완료할 때 잃어버린다. 사용자의 설정을 적재하고 보관하는 함수들을 추 
가하는것으로 끝마친다. 

4. 환경설정의 보관과 적재 

론리 적으로 응용프로그람이 기동할 때의 적재설정과 응용프로그람완료시에 보관설 
정을 고찰한다. 그러나 우선 보관설정코드를 작성한다. 그래야 적재해야 할 내용을 알수 
있 다. 

Qt 3.0 은 새 클라스 QSettings 를 받아들여 폼독자적인 방법으로 사용자의 설정을 
조종한다. (례하면 Windows 에 대한 등록과 Unix 에 대한 rc 파일들을 사용한다.) 실현 
파일들의 머 리 부에 qsettings.h 머 리 부과일을 추가한다. (Object Explorer 의 Members 
타브를 선택하고 ’’Includes (in Implementation )’’ 를 오른쪽 단추로 찰칵하고 New 를 
누르고 qsettings.h 를 입력하고 Enter 를 누른다.) 

실현파일의 머리부에 다음의 선언을 추가한다. 

"qsettings.h" 

1) saveSettings() 
void MainForm: :saveSettings() 

{ 

QSettings settings; 

settings.insertSearchPath( QSettings::Windows, WINDOWS_REGISTRY ); 
settings.writeEntry( APP KEY + "WindowWidth", width() ); 
settings.writeEntry( APP_KEY + "WindowHeight", height() ); 
settings.writeEntry( APP_KEY + "WindowX", x() ); 
settings.writeEntry( APP_KEY + "WindowY", y() ); 
settings.writeEntry( APP KEY + "ClipAs", m clip as ); 
settings.writeEntry( APP KEY + "ShowWeb", m show web ); 
settings.writeEntry( APP_KEY + "View", 

colorWidgetStack->visibleWidget() == tablePage ); 

} 

insertSearchPathO 호출이 모든 가동환경에서 있어야 한다. (이 함수는 그것을 적용하지 
못하는 가동환경에서 호출되면 단순히 되돌아간다.) 기본픔의 창문크기와 오려둠판용 선 
택，웨브색지시기들을 보관한다. 또한 사용자의 보기를 기록한다. 사용자가 응용프로그람 
을 완료할 때 이 함수를 호출하므로 이제는 ffleExitO 함수의 제3판과 최종판을 만든다. 

- fileExit() 

void MainForm: : fileExit() 
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{ 

if ( okToClear() ) { 
saveSettings(); 

QApplication: : exit( 0 ); 

} 

} 

완료가 발생하면 자동적 으로 사용자의 설정 을 보관한다. 

2) loadSettings() 
void MainForm: :loadSettings() 

{ 

QSettings settings; 

settings.insertSearchPath( QSettings::Windows, WINDOWS 一 REGISTRY ); 
int windowWidth=settings.readNumEntry(APP_KEY +"WindowWidth’’ ， 550); 
int windowHeight = settings.readNumEntry(APP_KEY + "WindowHeight", 

500 ); 

int windowX = settings.readNumEntry( APP KEY + "WindowX", 0 ); 
int windowY = settings.readNumEntry( APP KEY + "WindowY", 0 ); 
m_clip_as = settings.readNumEntry( APP_KEY + ， ’ ClipAs ，， ,CLIP_AS_HEX); 
m show web = settings.readBoolEntry( APP KEY + M ShowWeb",TRUE ); 
if ( ! settings.readBoolEntry( APP_KEY + "View", TRUE ) ) { 
colorWidgetStack->raiseWidget( iconsPage ); 
viewIconsAction->setOn( TRUE ); 

} 

설정이 없으면 기정값을 리용하여 설정에 읽어들인다. (즉 설정이 삭제되였거나 이 
것 이 처 음이 면 사용자는 응용프로그람을 실 행한다. ) 다시 insertSearchPathO 를 모든 가동 
환경에서 호출한다. 

설정에 따라서 마지막으로 프로그람을 완료할 때 사용자가 보고있던 보기로 절환한 
다. 또한 기본창문을 마지막으로 사용한 크기와 위치로 조절한다. 
init() 함수에 서 loadSettings 0 ; 행 의 설명 을 해 제 한다. 

응용프로그람을 건설하고 실행한다. 그림기호보기를 변경하고 op 仕 ons 대화칸의 1 개 
이상의 선택을 변경한다. 창문을 이동하고 크기를 조절해본다. 응용프로그람을 완료하였 
다가 다시 기동한다. 보기와 창문보기，위치，기타 선택들이 모두 되살아난다. 

5. 결론 

이제 는 colortool 응용프로그람을 완성하였다. 프로그람의 기능을 더 확장할수 있다. 
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실례로 표보기에 보충적인 렬들을 추가하여 RGB 값 (0..255), 비례 RGB 값 (0.00. .1.00)， 
HSV 값 등을 표시할수 있 다. 

Find 대화칸에 대소문자를 구별하는 검사칸을 제공하고 그것을 사용할수 있게 코드 
를 갱신할수 있다. 

내부색선택대화칸와 같은 기능을 제공하지만 사용자가 색을 이름짓게 하는 자체의 
색 선택 대 화칸을 생 성한다. 

Qt Designer 의 기본우점은 폼을 빠르면서도 간단히 설계 (재설계)할수 하는것 이 다. 
창문부품배치는 간단한 두단계의 과정이다. 즉 2개이상의 창문부품 혹은 배치들을 선택 
한 다음 그것들에 배치(수직，수평 혹은 살창)를 적용한다. 배치가 제대로 되지 않으면 
Ctrl+Z 를 눌러서 취소하거나 배치를 선택하고 Ctrl+B (배치해체)를 누른다. Qt 
Designer 는 무제 한한 취 소 ( undo ) 와 재 시 행 ( redo ) 를 지 원 하므로 실 험 하기 쉽 고 안전 하 
다. (Qt Designer 의 배치를 코드로 콤파일하는 방법을 알려면 응용프로그람을 건설할 
때 생성되는 . cpp 파일들을 보시오.) 

Qt Designer 의 배치들을 시험해볼것을 권고한다. 실례로 multiclip 실례 
(qt/tools/designer/examples/multiclip 에서)의 보기와 크기조절특성들을 가지는 폼을 되살려 
보시오. 

6. 오유 

오유원천은 머리부파일, 앞방향선언 혹은 변수를 틀리게 입력하는것이다. 다음의 
목록에 대하여 그것들을 검사하고 적당히 삽입하거나 수정한다. (모든 경우에 Object 
Explorer 의 Members 타브를 검사한다. 편집해야 한다면 련관된 부분을 오른쪽 단추로 
선택하고 Edit 를 눌러서 련관된 대화칸을 호출한다.) 

1) MainForm 성원들 

- 들라스변수: 

FindForm *findForm; 

QClipboard *clipboard; 

QMap<QString,QColor> m_colors; 
bool m_show_web; 

int m_clip_as; 
bool m_icons_dirty; 
bool m_table_dirty; 
bool m_changed; 

QString m_filename; 

QStringList m_comments; 

- 앞방향선언: 
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class QColor; 
class QString; 

- 선언에서 머리부파일들 
"fmdform.h" 

- 실현에서 머리부파일들: 
n optionsform.h" 

"qlineedit.h" 

"qlabel.h” 

"qclipboard.h" 

"qmessagebox.h’’ 

"qstatusbar.h" 

’’qpainter.h" 

"qstring.h" 

’’qcolor.h" 

"qapplication.h" 

"qfiledialog 上" 

"qfile.h" 

"qregexp.h" 

"qcolordialog.h" 

’’colomameform.h’’ 

"qcheckbox.h" 

"qradiobutton.h" 

"qsettings.h" 

2) ColorNameForm 성원들 

원천코드파일에 ColorNameForm 선언들을 모두 넣는다. 파일 colomameform . ui 上는 
다음의 선언들로 시작해 야 한다. 

#include <qcolor.h> 

#include <qmap.h> 

#include <qstring.h> 

QMap<QString,QColor> m_colors; 

3) FindForm 성원들 

신호: 

lookfor(const QString&) 

4) OptionsForm 성원들 
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OptionsForm 에는 성원이 없다. 

5) main , cpp 성원들 

이 파일은 다음의 선언으로 시작해야 한다. 
#include < qapplication . h > 

#include ’’ mainform . h ” 


제 4 절. Designer 수법 

Qt 2. x 에 서 Qt Designer 는 . u i 파일형 식 으로 파일들을 편집 하기 위 한 시 각적 인 폼설 
계프로그람이였다. Qt Designer 의 본래 목적은 지루한 GUI 프로그람작성부분(대화칸설 
계 )을 재 미 있는 기 능으로 전환하는것이 였 다. 2. 표의 Qt Designer 는 아주 간단한 프로그 
탐으로서 . ui 파일들을 읽고 쓴다. 각 . ui 파일에는 단일한 대화칸폼의 XML 서술이 들어있 
다. 둘째 봉사프로그람 즉 사용자대면부번역프로그람 uic 는 XML 서술로부터 C ++ 코드를 
생 성하는 응용프로그람의 건설 과정 에 사용된 다. 

Qt 3.0 에서 Qt Designer 의 기 능은 하나의 대 화칸편집 이상으로 높아졌다. 기 본창문 
과 작용창조능력과 갈은 새로운 설계 특성들과 함께 새로운 판에서는 다음과 갈은 기능을 
받아들였다. 

• 응용프로그람의 사용자대면부를 위한 프로젝트관리， 

• 처리부의 코드를 직접 작성할수 있도록 Qt Designer 가 코드편집기를 제공하는 
폼들에서 코드작성 . 코드는 . ui . h 파일들에 보관되 고 파생들라스를 작성할 필요가 없어 졌 
다. (필요하다면 작성자가 파생콜라스를 만들수 있다.) 

• 실행시 에 . u 파일들을 적재하게 하는 동적폼적재 . 이것은 기초코드와 분리된 설계 
전용화의 중요한 기회를 제공한다. 

이 절의 목적은 이 러한 변경방법을 설명 하고 포함된 새로운 개 념들을 서술하며 이 
기 능들의 내부적 인 작업 방법 을 보여 주는것 이 다. 

Qt Designer 는 시각적 인 설계도구이지 완전한 통합개발환경 이 아니다. 그 목적은 
어떤 특별한 도구에 사용자들이 포로되지 않고 될수록 간단하고 강력한 GUI 개발을 가 
능하게 하는것 이 다. Qt Designer 는 GUI 설계를 창조하고 수정 하기 쉽게 하지만 아직도 
필요하다면 일반본문편집기를 사용하여 같은 결과를 직접 코드로 엄을수 있다. 

더 편리 하게 하기 위 하여 현재 Qt Designer 에는 C ++ 편집 기 를 플라그인으로서 포함 
한다. 폼을 생성 하거나 편집 하려면 Qt Designer 를 사용해야 한다. 폼의 코드를 편집 하 
려면 물론 Qt Designer 의 C ++ 편집기를 사용할수 있다. 이 기본편집기는 후에 설명 하는 
시각적 인 폼설계 과정 과의 엄격한 통합으로부터 분리할수 있게 한다. 그러 나 vim , emacs , 
notepad , Microsoft Visual Studio 등의 편집기를 사용하는것이 좋으면 여전히 그것을 
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사용할수 있다. 


1. 프로젝트관러 

하나의 비련결된 . ui 파일을 읽고쓰는 작업은 개념적으로 단순하고 Qt 2. 표에서 잘된다. 
그러 나 Qt 2. x 에 는 Qt Designer 로 응용프로그람의 GUI 부분에 대 한 프로젝 트관리 를 받아 
들이 게 한 일정한 특성 들이 부족하였 다. 프로젝 트관리의 기 본우점 은 다음과 같다. 

• 공통소유하는 폼들의 그롭화. 

• 각이한 폼들사이 에 서 화상의 공유. 

• 각이한 폼들사이 에 서 자료기 지정 보의 공유. 

다음에 그 우점 과 프로젝 트관리 의 필 요성 에 대 하여 더 자세 히 설 명한다. 

1) 폼의 그를화 

폼의 그룹화는 Qt Designer 가 같은 프로젝트에 포함되는 . ui 파일들의 목록을 관리 
한다는것을 의미한다. 이것은 한번의 마우스누르기로 폼들사이를 쉽게 절환하게 한다. 

2) 화상집합에서 화상공유 

Qt 2. 표의 Qt Designer 에서 매개 폼이 자기의 필요한 화상들을 포함하였으며 화상 
들의 공유는 없었다. 이것은 여러개의 폼이 갈은 화상들을 사용해야 할 때 중복이 생기 
게 하였 다. 게 다가 화상들은 XML . ui 파일 들에 보관하였 으므로 파일 의 크기 가 늘어났다. 

그리하여 Qt Designer 에서 정의할수 있는 픽스매프적재기능을 받아들였다. 이 수 
법의 큰 결함은 Qt Designer 에서 설계과정 에 화상들을 볼수 없는것이 였다. 이것은 폼을 
시각적 으로 설계할수 없을뿐아니 라 기 하학적 관리 에도 현저 한 영 향을 주었다. 

Qt 3.0 판의 Qt Designer 에서는 프로젝트화상집합이라는 개념을 도입하였다. 프로젝트 
를 사용한다면 프로젝트의 화상집합에 화상들을 추가할수 있으며 이 화상들을 공유하고 프 
로젝트에 포함한 임의의 폼들에서 사용할수 있다. 화상은 프로젝트의 등록부에 있는 보조등 
록부 images / 에 PNG (portable network graphics ) 로 보관된 다 . 화상집 합을 수정 할 때 마다 
Qt Designer 는 2진형식의 화상자료와 화상실례를 작성 하는 함수를 둘다 포함하는 원천파일 
을 생성한다. 화상은 프로젝트의 모든 폼들에서 호출할수 있으며 자료는 공유된다. 

화상집합사용의 다른 우점은 화상들이 기정의 QMimeSourceFactory 에 추가되는 
것 이 다. 이 리 하여 리치본문표식 자으로부터 호출할수 있다. 상황의존방조와 지 어는 도구 
암시도 표준 HTML 화상꼬리표를 포함한다. 화상꼬리표의 source 인수는 단순히 화상집 
합의 화상의 이름이다. 이것은 또한 Qt Designer 에 의한 설계과정에 작업한다. 

3) 공유자료기지설정 

Qt 3.0 은 새로운 자료기지모둘 Qt SQL 모둘을 받아들였다. Qt Designer 는 SQL 
모둘과 완전히 통합되며 련결된 자료기지로부터 생자료를 보여줄수 있다. 

프로젝트를 열거나 창조했을 때 Project | Database Connections 차림표선택에 의하 
여 펼쳐지는 Edit Database Connections 대화칸을 사용하여 자료기지 련결을 설정 할수 
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있다. 작성자가 만드는 련결은 . db 파일에 보관된다. 프로젝트를 재적재할 때 Edit 
Database Connec 仕 ons 대화칸로 가서 련결목록을 선택하고 Connect 단추를 찰칵하여 
재련결할수 있다. 

대 부분의 자료기 지응용프로그람에 서는 하나이상의 몸으로부터 자료기 지 를 호출하려 
고 한다. 이것은 . db 파일이 단일종의 부분이 아니라 프로젝트의 부분이기때문이다. 

4) . pro 파일 

Qt Designer 는 프로젝트에 대한 정보 실례로 폼목록과 화상집합，사용하는 자료기 
지와 그 호출방법에 대한 정보를 보관하여야 한다. 대부분의 Qt 사용자들은 이미 프로젝 
트파일형 식 을 리 용하여 다중가동환경 makefile 을 만든다. 즉 tmake (와 Qt 3.0 qmake ) 프 
로젝 트 . pro 파일들이다. 이 파일들은 이 미 좀들의 목록을 포함하는 . ui 파일들로서 프로젝 
트에서 uic 용으로 사용된다. 

. pro 파일안의 절들을 Qt Designer 가 프로젝트를 관리 하는데 필요한 여유정보를 포 
함하도록 확장하였다. 실례로 Qt Designer 에서 프로젝트에 좀을 추가할 때 프로젝트파 
일의 FORMS 절에 자동적으로 추가되므로 qmake 는 다른 작업을 하지 않고도 필요한 건 
설규칙을 생성한다. 마찬가지로 화상들은 IMAGES 절에 추가되므로 실행파일로 자동적 
으로 름파일된다. 

qmake 사용을 강요하지 않는다. 다른 건설체계 실례로 automake/autoconf 또는 
jam 을 좋아한다면 그것을 계속 사용할수 있다. 응용프로그람의 GUI 부분을 서술하는 파 
일로서 . pro 파일을 간주한다. 펼요한것은 자기의 Makefile 들에 . ui 파일들과 화상집합을 
추가하는것 이 다. 


2. 폼의 기능확장 

우선 . ui 파일들과 생성된 코드，응용프로그람코드사이의 관계를 보여주는 그림 1-62 
를 고찰하자. 




form.ui 


읽고쓴 Q 
읽 는다 
생성 한 Q 

♦include 한다 

도구 

| 생성된 원전마일 
I 수정조종 a 는 원천과일 


1 


main.cpp 


그림 1-62. . ui 파일과 생성된 코드, 응용프로그람코드사이의 관계 
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Qt Designer 는 .ui 파일 실례로 form.ui 를 읽고쓴다. 사용자대면부번역프로그람 uic 는 
머리부파일 실례로 form 上와 실현파일 실례로 form. Cp p 를 .ui 파일로부터 둘다 창조한다. 
main.cpp 의 응용프로그람코드는 form.h 를 포함한다. 일반적으로 main.cpp 는 

QApplication 객체의 실례를 만들고 사건순환고리를 시작하는데 사용된다. 

이 수법은 간단하지만 더 복잡한 대화칸에는 충분하지 않다. 복잡한 대화칸은 폼의 
창문부품들에 련결된 아주 많은 론리를 가지며 보통 미리 정의된 신호와 처리부들로 보 
여주는것보다 더 많은 론리를 가지고있다. 이 여유론리를 조종하는 하나의 방법은 폼에 
기능을 추가하는 조종자콜라스를 응용프로그람코드에 쓰는것이다. 이것은 uic 가 생성한 
클라스들이 공개부분에 폼의 조종과 그 신호를 내주기때문에 가능하다. 이 수법의 큰 결 
함은 그것 이 정 확한 Qt 형식 이 아닌것 이 다. Qt Designer 를 사용하지 않는다면 대체 로 폼 
자체 에 론리를 추가하군 한다. 

이것은 폼에 전용처리부들과 성원변수들을 추가하는 능력이 초기에 Qt Designer 에 
추가되였기때문이다. 이 수법의 중요한 우점은 미리 정의된 처리부에 신호를 련결하는데 
사용하던 도형방식으로 Qt Designer 를 사용하여 신호를 전용처리부에 련결할수 있는것 
이다. 그다음 uic 는 매개 전용처리부에 대하여 빈 그루터기 (S 比 lb) 를 생성된 form.cpp 실 
현파일에 추가한다. 

여기서 큰 문제는 그 전용처리부들에 전용실현코드를 어떻게 추가하는가 하는것이 
다. 생성된 form.cpp 에 코드의 추가는 선택적인것이 아니며 이 파일은 폼이 변경될 때마 
다 uic 에 의하여 다시 생성되 며 작성 자들은 생 성된 코드와 손으로 쓴 코드의 결합을 바 
라지 않는다. 2가지 가능한 해결책이 있는데 다음에 학습한다. 

1) 파생클라스작성방법 

생성된 폼에 전용처리부를 실현하는 아주 명백한 방법은 그림 1-63 에 보여준것처럼 
C++ 계승을 리용하는것이다. 


J form.ui 

► 읽고쓴다 
— ► 위는다 
생성한다 

•••••• >- include 한다 

도구 _ 

생성된 원천파일 



수정조종되는 원전마일 


그림 1-63. 파생클라스작성수법 

여기서 사용자는 보충적 인 들라스 Formlmpl 을 작성하는데 머 리부파일 formimpl.h 
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과 실현파일 formimpl.cpp 로 가른다. 머 리부파일은 uic 가 생성한 form.h 를 포함하며 모든 
전용처 리부들을 재 실현한다. 이것은 uic 가 생성한 전용처 리부들이 가상이므로 가능하다. 
전용처리부실현과 함께 이 수법은 파생콜라스의 구성자에서 여분의 초기화를 수행하는 
방법과 해체 자에서 여분의 해체처 리를 하는 방법을 사용자에게 준다. 

이러한 우점과 그 유연성으로 하여 이 수법은 Qt2.x 에서 Qt Designer 를 사용하는 
원시적 인 방법으로 되였다. 

알아두기 : 이름공간을 깨끗이 유지하기 위하여 대부분의 사용자들은 그림 1-63 에서 
보여 준 Form 과 Formlmpl 명명 구조를 따르지 않았지 만 그대신 Qt Designer 의 좀들을 
FormBase 로，파생콜라스들을 Form 으로 명명하였다. 이것은 폼들이 항상 파생콜라스로 
작성 되 고 응용프로그람코드에서 파생클라스들을 사용하고있으므로 리치적 으로 옳았다. 

2) ui.h 확장수법 

유연성과 완전성에도 불구하고 파생콜라스작성수법은 일부 결함을 가진다. 

• 파생콜라스작성은 모두에게 자연스럽지 않고 쉽지 않다. 객체지향수법을 새로 배우 
는 사람들은 파생들라스로 작성 하는것을 전용처 리부의 실현보다 어 려운 일로 생각한다. 

•생성된 콜라스들을 계승하는것은 프로그람작성오유의 추가적인 원천이다. 특히 
재실현함수의 수가 많고 설계과정에 기호가 자주 변경된다면 이것은 더하다. 개발과정을 
더 원만하게 하기 위 하여 uic 는 순수가상함수보다도 전용처 리부용 빈 그루터 기를 생성한 
다. 이 수법은 코드의 롬파일 및 실행을 유지하는 한편 프로그람작성자들은 실행시경고 
오유통보문을 놓치는 상황에 부닥치게 되고 파생클라스에서 자그마한 철자오유를 발견하 
는데 시 간을 소비한다. 

• 수백개의 폼을 가지는 큰 프로젝트들에서 보충적인 파생클라스들은 름파일속도와 
코드크기 에서 현저한 차이 를 가전다. 

몇가지 결함이 있지만 이것들은 다른 해결방법으로 충분히 조사할수 있는 원인이다. 
Qt 3.0 에서는 새로운 개념 ui.h 확장을 제공한다. 

이것은 그림 1-64 와 같이 작업한다. 
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form.ui form.ui.h 때 " 


► 읽고쓴 Q 

_► 읽는다 
생성한다 

. # include 한!:)' 

• 도구 

생성된 원천파일 

1 1 수정조종 a 는원천파일 5 . ; 

그림 1-64. .ui 확장수법 

.ui 파일， form.ui 와 함께 Qt Designer 는 다른 련관된 파일 form . ui.h 을 읽고 쓴다. 
이 . ui.h 파일은 보통의 C ++ 원천파일로서 전용처리부의 실현을 포함하고 생성된 폼실현파 
일 form , cpp 로부터 포함되므로 다른 사용자코드에서 완전히 무시될수 있다. C ++ 코드를 
포함하는 上확장을 . ui.h 파일에 사용하는 러유는 그것이 항상 포함되며 上확장으로 건설과 
정에 통합하기 더 쉽기때문이다. 

form . U i.h 파일은 다른 모든 파일들중에서 특별한 위치를 차지한다. 이것은 사용자와 
Qt Designer 에 의하여 읽고씌워지는 공유원천파일로서 일반적으로 수정조종되는 원천파 
일이며 uic 에 의하여 생성되지 않는다. Qt Designer 가 할 일은 련관된 폼의 전용처리부 
정의와 동기하여 파일들을 유지하는것이다. 

① 사용자가 폼에 새 처 리부를 추가할 때마다 Qt Designer 는 .ui 上파일에 그루터기 
를 추가한다. 

② 사용자가 전용처리부의 기호를 변경할 때마다 Qt Designer 는 대응하는 실현을 
갱 신한다. 

③ 사용자가 전용처 려 부를 삭제 할 때 마다 Qt Designer 는 그것 을 . ui.h 파일에서 삭제 
한다. 

이리하여 완전성이 담보되고 파생를라스를 만들 필요가 없어지고 파생콜라스안의 
처리부들을 잊어버리거나 철자가 틀릴 위험이 더는 없어진다. 

. ui.h 파일들은 내부 C ++ 편집기플라그인을 가지고있는 Qt Designer 에서 직접 편집하 
거나 자기가 좋아하는 편집기에서 편집할수 있다. 오직 . ui.h 파일에 처리부실현을 삽입하 
고 Qt Designer 안에서 항상 처리부를 추가，삭제하거나 이름변경하여야 한다. Qt 
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Designer 에서 혹은 자기의 편집 기를 사용하여 처 리부의 실현을 편집할수 있다. 자체 의 
편집기를 사용한다면 Qt Designer 는 변경을 보관한다. 

- 구성 과 해 체 

ui . h 확장수법은 파생클라스작성수법에 비하여 한가지 결함을 가지고있다. ui . h 파일은 
오직 전용처리부실현만 포함하지만 객체는 여전히 생성된 form . cpp 코드안에서 구성되고 
해체된다. 이것은 보통 C ++ 클라스의 구성자와 해 체 자에서 수행하는 폼의 초기 화나 삭제 
를 사용자가 할수 없게 한다. 

이리한 제한하에서 작업하기 위 하여 init / destroy 관례를 만들었다. 좀에 처리부 
Form :: init () 를 추가하자면 이 처리부는 생성된 폼구성자의 끝에서 자동적으로 호출된다. 
마찬가지 로 폼에 처 리부 Form :: destroy () l - 추가하면 처 리부는 임의의 종조종이 삭제 되 기 
전에 자동적 으로 호출된 다. (이 처 리 부들은 void 를 돌려주어 야 한다. ) 자체 의 편집 기 를 
사용하기 좋아한다면 여전히 Qt Designer 에서 이 함수들을 창조한다. Qt Designer 의 
C ++ 편집기플라그인이나 자체의 편집기를 사용하여 실현코드를 쓸수 있다. 

3. 폼의 동적적재 

새로운 콜라스 QWidge 好' actory 는 실행시에 . ui 파일들을 적재하고 그것들로부터 폼 
의 실례를 만들수 있게 한다. 

이 동적수법 은 GUI 설 계 와 독립 적 으로 코드를 유지 하며 기 초응용프로그람론리보다 
도 더 자주 GUI 를 변경해야 하는 환경에서 쓸모있다. 끝으로 완전한 C ++ 개발환경 이 없 
이 도형방식사용자대 면부를 수정할수 있는 능력 을 응용프로그람의 사용자에 게 제 공할수 
있 다. 

. ui 파일寒 콤파일되지 않으므로 C ++ 코드(례를 들면 전용처리부실현)를 포함할수 없 
다. 창문부품 factory 에 수신자로서 넘기는 조종용 QObject 파생콜라스를 통하여 그 실현 
을 추가하는 방법을 제공한다. 

이 개념과 그 사용법은 다음 절에서 자세히 설명한다. 

제5절. 파생클라스작성과 동적대화칸 

이 절에서는 Qt Designer 에 의하여 폼을 창조하는 두가지 수법을 설명한다. 파생 
콜라스작성 법 ( Subclassing ) 은 Qt Designer 에서 창조하는 폼에 기 초한 들라스를 자체 
로 창조함으로써 폼의 기능을 확장하는데 쓰인다. 동적대화칸은 Qt 응용프로그람에 의하 
여 실행되는 . ui 파일로서 GUI 설계와 코드를 따로따로 보관하며 GUI 를 기본응용프로그 
람론리보다 더 자주 변경시키는 환경에서 쓸모있다. 


1. 파생클라스작성 
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폼의 파생콜라스를 만드는 방법에 대하여 일반적으로 설명하고 간단한 실례로부터 
시작한다. 파생들라스작성법은 종에 직접 코드를 삽입하는 경우보다 몇가지 결함이 있다. 
(4 절 2. 참고) 

1) Qt Designer . ui 파일로부터 원천코드의 생성 

Qt Designer 는 qmake 의 . pro (프로젝 트)파일을 읽 어 들이 고 써 넣 는다. 이 파일은 응 
용프로그람을 건설하는데 쓰이는 파일들을 기록하는데 사용되고 그로부터 Makefile 들을 
생성한다. 또한 Qt Designer 는 . ui (사용자대면부)파일들을 읽어들이고 써넣는다. .ui 
파일은 픔에 사용한 창문부품，배치, 원천코드와 환경설정을 기록하는 XML 파일이다. 
매개의 . ui 파일은 uic (사용자대면부틈파일러)에 의하여 C ++ 의 上파일과 . cpp 파일로 변환 
된다. 그다음 이 C ++ 파일들은 moc (메 타객체름파일 러)에 의하여 읽어들이 고 최종적 으로 
름파일 러 에 의 하여 작업응용프로그람으로 틈파일 된 다. 

Qt Designer 에서 응용프로그람을 완전히 작성한다면 하나의 main . cpp 를 생성 해 야 
한다. 

Qt Designer 안에 서 main . cpp 파일 을 창조한다면 Qt Designer 에 의 하여 프로젝 트파 
일에 자동적으로 추가된다. Qt Designer 밖에서 main . cpp 파일을 창조한다면 프로젝트 
의 . pro 파일의 끝에 다음의 행을 추가하여 프로젝트파일에 수동적으로 추가해 야 한다. 

SOURCES 4# , main.cpp 

그다음 qmake 를 사용하여 Makefile 을 생 성한다. (실 례 로 qmake -o Makefile 
myproject . pro .) make ( Linux , Unix 또는 Borland 번 역 프로그람) 를 실 행 하거 나 
nmake(Visual C ++) 를 실 행 하면 uic , moc 그리 고 를파일 러 들이 필요할 때 호출되 여 응용 
프로그람을 건설한다. 

Qt Designer 를 사용하여 기본창문과 대화칸을 생성 하지만 다른 C ++ 파일들을 추가 
하거 나 또는 임의 의 폼을 파생콜라스작성한다면 . pro 파일에 이 파일들을 추가하여 응용 
프로그람의 나머 지 원천파일들과 함께 를파일 해 야 한다. main . cpp 에 대 하여 수행 한것 처 럼 
Qt Designer 로부터 개별적으로 창조하는 매개의 . h 파일은 HEADERS 행에 추가되고 매 
개 . cpp 파일은 SOURCES 행 에 추가되 여 야 한다. 정의되지 않은 참고오유가 발생하면 모 
든 머 리부와 실현파일들의 이름을 . pro 파일에 추가하였는가 검사하는것 이 좋다. 

2) 폼의 파생들라스작성 

폼의 파생 콜라스를 작성할 때 명 명 관례 를 리 용하여 Qt Designer 의 . ui 파일 들로부터 
생성되는 파일들과 손으로 코드작성한 파일들을 식별할수 있다. 

실례로 Qt Designer 에서 대화칸을 개발하고 직접 코드를 쓴다고 가정하자. 대화칸 
을 OptionsForm , . ui 파일을 optionsform . ui 라고 부르기로 하자. 자동생성된 파일들은 
optionsform . h 과 optionsform.cpp 이 다. 

이번에는 다른 대화칸을 파생콜라스로 만들려고 하는데 자동생성된 파일들과 손으 
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로 작성한 파일들을 쉽게 구별하려고 한다. 실례로 대화칸을 SettingsFormBase , .ui 파 
일을 settingsfonnbase.ui 라고 부르기로 한다. 그다음 자동생성된 파일들은 
settingsformbase.h 와 settingsformbase.cpp 로 불리운다. 파생콜라스를 SettingsForm 라고 하 
고 파일 settingsfomi.h 와 settingsform.cpp 에 코드를 쓰려고 한다. 

폼의 파생콜라스는 Q_OBJECT 마크로를 포함하여야 처리부와 신호들이 정확히 작업 
한다. 파생들라스를 생성한 다음에 는 上와 .cpp 파일들을 .pro 프로젝 트파일에 추가하려는가 
확인해 야 한다. 실례 로 파생클라스 SettingsForm 를 위하여 .pro 파일의 끝에 다음 행 을 
추가한다. 

HEADERS i_,settingsform.h 

SOURCES settingsform.cpp 

새로운 원천파일을 창조하는 가장 간단한 방법은 FilelNew 를 선택하여 New File 
대화칸을 열고 적당히 C ++ Source 또는 C ++ Header 를 선택하고 OK 를 찰칵한다. 빈 
원천창문이 새로 표시된다. Qt Designer 가 자동적으로 프로젝트파일에 추가하므로 .pro 
파일을 수동적으로 편집할 필요가 없다. 

Qt Designer 는 프로젝트파일에 다음행 을 추가한다. 

FORMS = settingsfonnbase.ui 

settingsformbase 上와 settingsformbase.cpp 파일들은 .ui 파일로부터 자동적으로 생성된다. 

3) 파생 클라스작성실 례 

작은 실례대 화칸을 만들어 파생 콜라스작성 을 실제 로 보여준다. 대 화칸은 손님 의 대 
부률과 특정한 량으로 주어 지 는 특수비률의 선택 을 표시한다. 이 기 능을 파생 들라스로 
실현한다. 기본폼을 창조하고 그 신호와 처리부들을 련결하는것으로 시작하여 파생클라 
스와 간단한 main.cpp 를 창조하여 시 험 할수 있 다. 

- 폼의 설계 

새 프로젝트를 창조하는것부터 시작한다. FilelNew 를 선택하고 C++Project 그림기 
호를 선택하여 Project Settings 대화칸을 펼친다. 생략단추를 찰칵하여 Save As 대화칸 
을 열고 프로젝트의 등록부(필요하다면 생성하여)로 이행한다. 프로젝트의 등록부를 확 
인한 다음 프로젝트의 이름을 credit , pro 라고 입 력한다. Save 단추를 찰칵하여 Project 
Settings 대화칸로 돌아와서 OK 를 찰칵한다. 이제는 프로젝트에 폼을 추가한다. 
FilelNew 를 선택하여 New File 대화칸을 연다. OK 를 찰칵한다. 폼의 크기를 작게 만 
들어 약 2 in (5 cm ) 의 정방형으로 만든다. 좀의 이름을 CreditFormBase 토，제목을 
Credit Rating 으로 변경한다. 폼을 creditformbase.ui 로 보관한다. 

이제는 필요한 창문부품들을 추가한다. 

0) Button Group 도구띠단추를 찰칵하고 폼의 왼쪽웃구석 근방을 선택 한다. 단추그 
롭의 크기를 조절하여 폼의 약 절반으로 만든다. 단추그룹의 name 을 
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creditButtonGroup 로，吐 tie 속성을 Credit Rating 으로 변경한다. 

② 라지오단추들을 추가한다. Radio Button 도구띠단추를 두번 련속 찰칵한다. 
Credit Ra 吐 ng 단추그름의 꼭대기쪽을 선택 하면 라지오단추가 하나 나타난다. 이 단추아래 
를 선택하여 둘째 라지오단추를 생성하고 둘째단추아래를 선택하여 셋째 단추를 생성한다. 
Pointer 도구띠단추를 찰칵하여 두번 찰칵의 효과를 차단한다. 그러면 지시기가 정상으로 
동작한다. 즉 폼을 선택하면 더는 라지오단추들이 생성되지 않는다. 첫째 라지오단추의 
name 을 stdRadioButton 로, text 를 ^Standard 로, checked 속성을 True 로 변경한다. 
둘째 단추의 이름을 noneRadioButton 으로, text 속성을 技 None 으로 변경한다. 셋째 단 
추의 속성을 specialRadioButton 으로， text 속성을 Sp&ecial 로 각각 변경한다. 

:® 사용자가 특수대부률을 선택 하면 량을 지정해 야 한다. SpinBox 도구띠 단추를 찰 
칵하고 바로 단추그룹아래의 좀을 선택한다. 스핀단추의 name 을 amountSpinBox 로， 
prefix 를 $(공백을 표시)， maxValue 를 100000토， lineStep 을 10000으로, enabled 속 
성을 False 로 변경 한다. 

④ Push Button 도구띠단추를 찰칵하고 스핀단추아래의 픔을 선택한다. 단추의 
name 을 okPushButton 으로， text 를 OK 로， default 속성을 True 로 각각 변경한다. 첫 
째 단추의 오른쪽에 둘째 단추를 추가하고 둘째 단추의 name 을 cancelPushButton 으 
로, text 를 Cancel 로 변경한다. 

이제는 창문부품들을 배치하고 필요한 처리부들을 련결한다. 

® 대부률그롭칸을 선택하고 Ctrl+L (수직 배치)을 누른다. 

② 폼을 선택하여 단추그롭이 더는 선택되지 않게 한다. Ctrl 을 누르면서 OK 단추 
를 누르고 선택창을 Cancel 단추가 닿도록 끌고가서 놓는다. Ctrl+H 를 누른다. 

資) 폼을 선택하고 Ctrl+L 을 누른다. 

창문부품들은 수직으로 배치되고 매개는 수직 및 수평으로 최대공간을 모두 채우도록 
늘어난다. 단추들은 폼의 전체폭을 모두 채우도록 확장되므로 오히려 더 크게 보인다. 수 
축자를 리용하여 단추들을 더 작게 만드는것이 좋을것이다. OK 단추를 찰칵한 다음 
Ctrl+B (배치해체)를 누르고 두개 단추의 크기를 조절하여 단추들의 각 변에 공간이 있게 
한다. Spacer 도구띠 단추를 찰칵하고 OK 단추의 왼쪽을 선택 한다. 튀 여 나오기 차림 표로부터 
Horizontal 를 선택한다. 이 수축자를 복사하고 두 단추사이에 사본을 배치한다. 수축자 
를 다시 복사하여 Cancel 단추의 오른쪽에 배치한다. (둘째와 셋째 수축자들에 대하여 첫 
째수축자우를 누르고 Ctrl+C 를 누른 다음 Ctrl+V 를 누른다. 새로운 수축자를 필요한 위 
치로 끌고간다.) Ctrl 을 누르면서 제일 왼쪽 수축자를 선택하고 선택창을 단추들과 수축자 
들을 닿도록 끌어 다놓고 Ctrl+H 를 누른다. 폼을 선택하고 Ctrl+L 을 누른다. 

이제는 신호와 처리부들을 련결한다. Edit | Connections 을 선택하여 View and 
Edit Connections 대화칸을 펼친 다. 
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◦ K 단추의 clicked 0 신호를 픔의 acceptO 처리부에 련결하는 새로운 련결을 창조 
한다. Cancel 단추의 clickedO 신호와 폼의 rejectO 처리부를 련결하는 둘째 련결을 창 
조한다. (2 절 6.을 참고.) 

특수라지오단추가 선택되면 amount 스핀단추를 가능하게 한다. 이번에는 특수라지 
오단추의 toggledO 신호와 amount 스핀단추의 setEnabledO 처리부에 련결하는 다른 
련결을 창조한다. 

사용자가 standard 혹은 none 라지오단추들을 검사하면 그 량을 각각 설정한다. 
대부률단추그룹의 clickedO 신호를 새로운 전용처 리부 setAmountO (Edit Slots ... 단추 
를 찰칵하여 창조한다.)에 련결한다. 

픔의 파생클라스를 작성하여 라지오단추가 검사되였는가에 따라서 스핀단추에 량을 
설정 하려 고 한다. 픔을 creditformbase . ui 로서 보관한다. ( Ctrl + S 를 누른다.) 

-시험기구작성 

응용프로그람안에서 대화칸을 리용하려고 한다 하더라도 시험기구를 창조하여 독자 
적으로 개발하고 시험할수 있다. FilelNew 를 선택하여 New File 대화칸을 연 다음 C ++ 
Source 를 선택하고 OK 를 찰칵한다. 펼쳐지는 편집기의 창문에서 다음의 코드를 입력 
한다. 

#include <qapplication.h> 

#include ’’creditformbase 上 " 

int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ); 

CreditFormBase creditForm; 

app.setMainWidget( &creditForm ); 

creditF orm. show(); 

return app.exec(); 

} 

creditfomibase.h 를 포함하고 CreditFormBase 객체의 실례를 만든다. 일단 파생클라스 
를 썼다면 머리부를 파생클라스 creditform 上로 변경하고 CreditForm 의 실례를 만든다. 

이제 는 qmake 를 사용하여 응용프로그람을 생성 한다. 즉 qmake -o Makefile credit.pro. 
그리고 make 를 실행한다. 폼은 잘 실행되여야 하지만 아직 요구대로 동작하지 않는다. 

- 파생클라스의 작성 
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파생 클라스를 위 한 머 리 부와 실현파일 을 창조한다. 파생 클라스용코드는 최 소이 다. 
머 리 부파일은 qt/tools/designer/examples/credit/creditfo^ 다. 

#include ''creditformbase.h" 


class CreditForm : public CreditFormBase 

{ 

Q_OBJECT 

public: 

CreditForm( QWidget* parent = 0, const char* name = 0, 
bool modal = FALSE, WFlags fl = 0 ); 

〜 CreditForm(); 
public slots: 

void setAmount(); 

}； 

Qt Designer 에서 처리부 setAmount() 를 선언하였다. Q _ OBJECT 마크로는 신호와 처 
리부를 사용하는 클라스에서 기본이므로 포함해야 한다. 

실현 파일 qt/tools/designer/examples/credit/credk^ 간단 하다. 

#include <qradiobutton.h> 

#include <qspinbox.h> 

#include "creditform.h" 


CreditForm: : CreditForm( QWidget* parent, const char* name, 
bool modal, WFlags fl ) 

: CreditFormBase( parent, name, modal, fl ) 

{ 

setAmount(); 

} 

CreditForm: : ~CreditForm() { /* NOOP */ } 

void CreditForm::setAmount() 

{ 

if ( stdRadioButton->isChecked() ) 

amountSpinBox->setValue( amountSpinBox->maxValue() / 2 ); 
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else if ( noneRadioButton->isChecked() ) 
amountSpinBox->setValue( amountSpinBox->minValue() ); 

} 

setAmount() 를 호출하여 Qt Designer 에서 어느 라지오단추를 검사하였는가에 기초 
하여 폼이 기동할 때 정확한 량이 표시된다는것을 담보한다. setAmountO 에서 standard 
혹은 none 라지오단추가 선택된다면 량을 설정한다. 사용자가 특수라지오단추를 선택하 
였다면 량을 변경하는것은 자유이 다. 

파생 클라스를 시 험 하기 위 하여 main.cpp 를 변경 하여 creditfonnbase 上가 아니 라 

creditform.h 를 포함하고 creditForm 객 체 의 실 례 작성 을 변경 한다. 

#include <qapplication.h> 

#include "creditform.h" 


int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ); 

CreditForm creditForm; 

app.setMainWidget( &creditForm ); 

creditForm.show(); 

return app.exec(); 

} 

Qt Designer 로 creditform.h 와 creditform.cpp 파일 들을 생 성하였 다면 그것 들은 이 미 프 
로젝 트파일 에 있지 만 수동으로 생 성하였 다면 끝에 두개 의 새 행 을 추가하여 프로젝 트파 
일을 갱신한다. 

HEADERS creditform.h 
SOURCES += creditform.cpp 

좀을 시 험 하기 위 하여 qmake 를 실 행하여 Makefile 을 다시 생 성 하고 make 하고 실 
행 한다. 

파생콜라스작성 실례 는 간단하지 만 이것은 Qt 에서 폼의 파생클라스작성를 반영하며 
그것은 간단하다. 

2. . ui 파일들로부터 동적대화칸의 작성 

Qt 프로그람은 Qt Designer . ui 파일들을 적재하고 . ui 파일들에 의하여 표시된 폼들의 
실 례 들을 작성할수 있 다. .ui 파일 은 콤파일 되 지 않으므로 어 떤 C++ 코드도 포함할수 없 다 
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(실례로 처리부실현). 여기서는 동적대화칸을 적재하는 방법과 동적대화칸의 전용처리부 
를 실현하는데 사용하는 클라스의 창조방법을 설명한다. 

실례품으로서 소절1에서 창조한 credit 폼을 사용한다. 간단히 폼의 실례를 만들고 
실 행 하는것 으로 시 작하여 전용처 리 부실현방법 을 설명 한다. 

main.cpp 파일을 생성하여 시험기구로 사용하고 수동적으로 프로젝트파일을 창조한다. 

1) 프로젝트파일의 작성 

프로젝트 파일 qt/tools/designer/examples/receiverl/receW 다음과 같다. 

TEMPLATE" ® app 
CONFIG += qt wam on release 
TARGET 훈 receiver 
SOURCES += main.cpp 
unix:LIBS += -lqui 
win32:LIBS += $(QTDIR)/lib/qui.lib 
FORMS = mainform.ui 
LANGUAGE = C++ 

INCLUDEPATH += $(QTDIR)/tools/designer/uilib 

creditfomibase.ui 파일을 실행시 에 읽어들이므로 이 파일을 포함하지 않는다. 필요한 
기능이 표준 Qt 서고의 부분이 아니므로 qui 서고를 포함해 야 한다. 

2) main . cpp 의 작성 

mainxpp 는 아주 표준적 이 다. Qt Designer 에서 창조하려 고 하는 폼을 기 본품으로서 
호출한다. 그다음 이 폼이 적재되고 동적대화칸을 실행한다. 

#include <qapplication.h> 

#include "mainform.h" 


int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ); 

MainForm *mainForm = new MainForm; 
app.setMainWidget( mainForm ); 
mainForm->show(); 

return app.exec(); 

} 
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MainForm 들라스의 새로운 실례를 창조하고 그것을 기본창문부품으로 설정하고 표 
시 하고 app.exec() 호출에 서 사건순환고리 에 들어간다. 

3) 기본폼의 작성 

- 폼의 설계 

① Qt Designer 에 서 프로젝 트파일 receiver . pro 를 연다. 동적 대 화칸을 호출하는데 사 
용하는 기본창문으로서 대화칸을 창조한다. Ctrl + N 을 눌러서 New File 대화칸을 열고 
OK 를 찰칵하여 기정대화칸을 얻는다. 대화칸이름을 MainForm , 제목을 Main Form 으 
로 변경한다. 본문 ^Credit Dialog 를 가지는 creditPushButton 과 본문 & Quit 를 가지 
는 quitPushButton 라는 단추를 추가한다. (매 개 단추에 대 하여 Push Button 도구띠 단 
추를 찰칵한 다음 폼을 선택한다. 속성창문에서 속성을 방금 서술한값으로 변경한다.) 

② 한쌍의 표식자를 추가하여 동적대화칸에서 사용자가 선택한 설정을 표시할수 있 
다. Text Label 도구띠단추를 찰칵하고 Credit Dialog 단추아래 의 폼을 선택 한다. 표식 
자의 text 를 Credit Rating 로 변경한다. Quit 단추아래에 다른 본문표식자를 추가한다. 
name 을 ratingTextLabel 로， text 를 Unrated 로 변경한다. 

③ 창문부품들을 배 치한다. 폼을 선택하고 Ctrl + G (살창배 치)를 누른다. 

④ 신호-처리부련결을 조절한다. View and Edit Connections 대화칸을 펼치고 
credit 대 화칸단추의 clickedO 신호를 새 로운 creditDialogO (Edit Slots ... 단추를 찰칵 
하여 창조한다.)전용처리부와 련결한다. Quit 단추의 clicked() 신호를 대화칸의 accept() 함 
수와 련결한다. 

폼을 mainfomi . ui 라는 이 름으로 보관한다. ( Ctrl + S 를 누르고 파일 이 름을 입 력한다. ) 
후에 Qt Designer 에서 직 접 동적 대 화칸을 적재 하고 호출하는 코드를 작성 한다. 

- 동적대화칸의 적재와 실행 

credit 대화칸을 호출하는 코드를 추가한다. 그전에 창문부품 factory 의 머리부파일 
을 폼에 추가해 야 한다. Object Hierarchy 에서 Source 타브를 선택한다. Includes (in 
Implementation ) 를 오른쪽 단추로 찰칵하고 New 를 선택한다. <qwidgetfactory.h ； ^l" 고 
입력하고 Enter 를 누른다. 동적 대화칸에서 스핀 단추를 호출해야 하므로 그 머리 부파일 
을 추가해 야 한다. Includes (In implimentation ) 를 오른쪽 단추로 찰칵하고 New 를 
선택한다. <qspinbox.h> 라고 입력한 다음 Enter 를 누른다. 

기 본종에서 creditDialogO 를 호출하는 처 리부를 창조한다. Qt Designer 에서 이 처 리 
부를 직접 실현하고 그것을 사용하여 동적대화칸을 적재하고 실행한다. 코드는 
mainform.ui 의 C ++ 실현을 포함하는 qt/tools/designer/examples/receiverl/mainform.ui.h 에서 발 
취하였다. 

void MainForm: : creditDialogO 

{ 
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QDialog *creditForm = (QDialog *) 

QWidgetFactory :: create( "../credit/creditformbase.ui" ); 
// 여기서 동적대화칸을 설정한다. 


if ( creditForm->exec() ) { 

// 사용자가 받아들였으므로 작용한다. 

QSpinBox *amount = 

(QSpinBox *) creditForm->child( "amountSpinBox”, "QSpinBox" ); 
if ( amount ) 

ratingTextLabel->setText( amount->text() ); 

} 

delete creditForm; 

} 

create() 함수는 정적 QWidgetFactory 함수이 다. 이것은 특수화된 .ui 파일을 적재 하 
고 .ui 파일로부터 생성된 제일 웃준위 QWidget 에로의 지적자를 돌려준다. 
crecUtformbase.ui 파일 이 QDialog 를 정 의 한다는것 을 알고있 으므로 지 적 자를 QDialog 로 
강제변환한다. 대 화칸을 창조한 다음 그것 을 실 행 한다. 사용자가 OK 를 찰칵하면 대 화칸 
은 Accepted 를 돌려주고 if 명령문의 본체에 들어 간다. 우리는 사용자가 선택한 대부량 
을 알려고 한다. 대화칸상의 child() 함수에 창문부품의 이름을 넘기여 호출한다. child() 함 
수는 넘 긴 이 름을 가지 는 창문부품에 로의 지 적자를 돌려 주거 나 그런 이 름의 창문부품을 
발견하지 못하면 0 을 돌려준다. 실례에서 child() 를 호출하여 amountSpinBox 에로의 지 
적 자를 얻 는다. 엄 은 지 적 자가 0아니 면 비 률본문을 대 화칸의 스핀 칸의 량으로 설 정한다. 
끝으로 동적 대 화칸을 삭제한다. 대 화칸의 삭제 는 그것 이 더 는 요구되 지 않을 때 그 자원 
을 해 방한다. 

child() 에 창문부품이름을 넘기여 동적대화칸안에 있는 창문부품에로의 호출을 얻었 
다. 일부 상황에서 창문부품이 무엇을 호출하는지 모른다. null 창문부품이름과 클라스이 
틈으로 C hild() 를 호출하여 특정한 클라스의 첫 창문부품을 호출할수 있 다(실 례 로 
child(0,"QPushButton"). 이것은 발견한 첫 QPushButton 에 로의 지 적 자를 돌려 주거 나 발 
견하지 못하면 0을 돌려준다. 주어진 클라스의 모든 창문부품들에로의 지적자를 요구한 
다면 QObject::queryList() 함수에 들라스이름을 넘기여 호출한다. 그러면 주어진 콜라스로 
부터 파생되는 대화칸 안의 각 객체를 가리 키는 QObjectList 지적 자를 돌려 준다 
(QObject 문서를 참고). 

-동적대화칸용처리부의 실현 

한가지 언급하지 않은 문제 가 있 다. 동적 대 화칸은 setAmountO 처 리 부를 실 현하지 않 
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았으므로 원시적 인 신용대화칸의 동작을 가지지 못한다. QObject 파생클라스를 창조하여 
동적대 화칸용처 리부들을 실현한다. 그다음 파생 클라스의 실례를 창조하고 그 지적 자를 
동적대 화칸의 신호들을 파생클라스에 서 실현된 처 리부들에 련결 하는 

QWidgetFactory::create() 함수에 로 넘 긴다. 

QObject 파생 클라스를 창조하고 creditDialog() 를 변경하여 QWidgetFactory::create() 함 
수에 넘길수 있는 파생클라스의 실례를 창조해 야 한다. 여기 에 mainform.ui 의 처 리부용코 
드를 포함하는 qt/tools/designer/examples/receiver2/mainfom 뇨 로부터 수정 된 

creditDialog() 함수가 있다. 

void MainForm: : creditDialog() 

{ 

Receiver *receiver = new Receiver; 

QDialog *creditForm = (QDialog *) 

QWidgetFactory :: create( ’’../credit/creditformbase.ui", receiver ); 

receiver->setParent( creditForm ); 


// Set up the dynamic dialog here 


if ( creditForm->exec() ) { 

// The user accepted, act accordingly 

QSpinBox * amount = (QSpinBox *) creditForm->child( 

"amountSpinBox", "QSpinBox" ); 

if ( amount ) 

ratingTextLabel->setText( amount->text() ); 

} 

delete receiver; 
delete creditForm; 

} 

Receiver 파생클라스의 새로운 실례를 창조한다. (이 클라스의 코드를 간단히 쓴 
다.) 그다음 QWidgetFactory^createO 를 사용하여 QDialog 를 창조한다. 이 호출은 create() 
함수가 자동적 으로 신호와 처 리부들을 설정할수 있도록 하기 위하여 파생들라스객체 에서 
넘 기므로 이전의 실례 와 차이난다. 우리 의 처 리부는 동적폼의 창문부품들을 호출해 야 하 
므로 setParent() 함수를 통하여 수신자객 체 에 폼에 로의 지 적 자를 넘 긴다. 함수의 나머 지 는 
수신자객 체 를 삭제하는것 을 제 외하면 앞에 서 와 같다. 
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기본품에서 Receiver 파생클라스를 사용하므로 그 머리부파일을 포함해야 한다. 
Object Explorer 의 Members 타브에서 Includes (in Implmentation ) 를 오른쪽 단추 
로 찰칵하고 New 를 선택 한다. receiver.h 라고 입 력 하고 Enter 를 누른다. 

이제는 Receiver 파생클라스의 실현을 고찰한다. 코드는 

qt/tools/designer/examples/receiver2/receiver.h^- 대 응하는 receiver.cpp 파일 에 서 발취 한다. 머 
리부파일로부터 시작한다. 

#include <qobject.h> 

#include <qdialog.h> 

class Receiver : public QObject 

{ 

Q_OBJECT 

public: 

void setParent( QDialog ^parent ); 
public slots: 

void setAmount(); 
private: 

QDialog *p; 

}； 

클라스는 QObject 파생 클라스이 고 신호와 처 리 부들을 사용하므로 Q_OBJECT 마크로를 
포함한다. 비공개 QDialog 지적자는 물론 실현하려는 함수와 setAmountO 를 선언한다. 

이 실현은 사용하는 클라스들의 머리부파일들을 요구한다. 

#include <qradiobutton.h> 

#include <qspinbox.h> 

#include "receiver.h M 

receiver.cpp 에서 각 함수의 실현을 론의한다. 
void Receiver: : setParent( QDialog ^parent ) 

{ 

p = parent; 
setAmount(); 

} 

setParent() 함수는 동적 대 화칸에 로의 지 적자를 비 공개 지 적 자에 대 입한다. 

QWidgetFactory::create() 를 호출하기전에 Receiver 객체를 구성해야 하는데 구성자호출에 
서 이것을 수행할수 없으므로 Receiver 객체를 createQ 함수에 넘겨 야 한다. 일단 createQ 
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함수를 호출한 다음 setParent() 를 통하여 Receiver 클라스에 넘길수 있는 동적대화칸에로 
의 지 적자를 가전다. 이 실례의 파생클라스관에서 구성 자에서 setAmount() 를 호출하지 만 
setAmount() 의 실현이 구성시에 유효하지 않은 동적대화칸에 의존하므로 여기서 그것을 
수행 할수 없 다. 이 리 하여 setParent() 함수에 서 setAmount() 를 호출한다. 
void Receiver::setAmount() 

{ 

QSpinBox * amount = (QSpinBox*)p->child( ’’amountSpinBox", "QSpinBox"); 

QRadioButton *radio = 

(QRadioButton *) p->child( "stdRadioButton", "QRadioButton" ); 

if ( radio && radio->isChecked() ) { 
if ( amount ) 

amount->setValue( amount->maxValue() / 2 ); 
return; 

} 

radio = (QRadioButton *) p->child( "noneRadioButton", ’’QRadioButton" ); 

if ( radio && radio->isChecked() ) 
if ( amount ) 

amount->setValue( amount->minValue() ); 

} 

량스핀 단추를 갱 신할수도 있 으므로 그것 에 로의 지 적자를 얻 어 야 한다. S etParent() 호 
출에서 할당된 동적대 화칸을 가리키는 지적 자 p 에 대 하여 child() 를 호출한다. 그 결과의 
지적자를 정확한 형에로 강제변환하여 그 형과 련관된 함수들을 호출할수 있다. 실례에 
서 child() 를 호출하여 량스핀 칸에 로의 지 적자를 엄 은 다음 다시 child() 을 호출하여 
stdRadioButton 에로의 지적자를 얻는다. 라지오단추에로의 지적자를 얻어서 주어지는 
량을 설 정하는 단추가 검 사되 면 량스핀 단추에 로의 지 적 자를 가전 다. 이 라지 오단추가 선 
택되였으면 완료하고 되돌아간다. stdRadioButton 가 선택되지 않으면 

noneRadioButton 에로의 지적 자를 얻고 이 단추가 선택 되였으면 량을 설정 한다. 
specialRadioButton 가 선택되였으면 사용자가 그 선택값을 자유로 입구하므로 아무것 
도 하지 않는다. 

- 대화칸의 름파일과 동적적재 

《를파일된》. ui 파일과 동적적재된 . ui 파일의 사용에서 차이는 다음과 같다. 

동적대화칸은 .ui 파일에 C ++ 코드를 가질수 없으며 전용처리부는 QObject 파생클라스 
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를 통하여 실현되여야 한다. 름파일된 대화칸은 . ui 파일 혹은 파생클라스에 코드를 포함 
할수 있다. 

동적대화칸은 .ui 파일을 읽어야 하고 QWidget 실례가 .ui 파일의 구문나무에 기초하여 
실 례 화되 기 때 문에 적 재 속도가 뜨다. 름파일된 코드는 어 떤 파일 도 읽어 들이 지 않고 구문 
해석도 필요하지 않으므로 훨씬 더 빨리 적재된다. 사용자는 그 차이가 Is 에 불과하므 
로 모른다. 

동적대 화칸은 코드에 영 향이 없는한 코드와 독자적 으로 . ui 파일을 변경할수 있게 한 
다. 이것은 폼의 표시 를 변경할수 있다는것을 의 미한다. 실례 로 창문부품이동과 그것들 
의 배치. 름파일된 대화칸을 변경하려고 한다면 .ui 파일을 변경하고 다시 름파일해야 한 
다. 응용프로그람을 건설하고있는데 손님에게 사용자대면부의 모양을 전용화할수 있게 
하려면 그에게 Qt Designer 의 사본을 주고 동적대 화칸을 사용할수 있다. 

제6절. 사용자정의창문부품의 작성 

사용자정 의 창문부품은 코드로 창조된 다. 그것 은 현존창문부품들의 조합으로 이 루어 
지지만 추가적인 기능과 처리부，신호를 가지거나 또는 새로 만들수도 있으며 두가지를 
결합할수도 있다. 

Qt Designer 는 사용자정 의 창문부품들을 결합하는 두가지 기 구를 제공한다. 즉 

寒) 원시적 인 방법은 대화칸칸을 완성하는것보다 좀 더 복잡하다. 이 방법으로 결합 
한 창문부품들은 Qt Designer 에 서 좀에 추가되 였을 때 지 어 는 미 리 보기 방식 에 서 도 평 면 
픽스매프로서 나타난다. 그것들은 실행시에 진짜 폼에만 나타난다. 소절1에서 원시적인 
수법 으로 사용자정 의 창문부품들을 창조하는 방법 을 설명 한다. 

② 새로운 수법은 플라그인에 창문부품의 매몰을 포함한다. 플라그인을 통하여 삽 
입되는 창문부품들은 Qt Designer 에서 폼을 배치할 때와 미 리보기방식에서 폼에 나타난 
다. 이 수법은 원시수법보다 더 강력하고 유연하고 소절2에서 설명한다. 

1. 간단한 사용자정의창문부품 

사용자정 의 창문부품을 창조하는데 2개 의 단계 가 있 다. 첫째 로 창문부품을 정 의하는 
콜라스를 창조해 야 하며 둘째로 창문부품을 Qt Designer 에 삽입해 야 한다. 창문부품창 
조는 단순한 사용자정 의창문부품을 창조하거 나 풀라그인을 창조하여 수행되 여 야 하지 만 
단순한 사용자정의창문부품에 대 하여 Qt Designer 에로의 삽입은 아주 간단하다. 

4개의 단추 즉 rewind 와 play , next , stop 로 이루어지는 VCR 형 창문부품을 창조 
한다. 창문부품은 어느 단추를 눌렀는가에 따라서 신호를 발생한다. 

1) 사용자정 의 창문부품코드작성 
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사용자정의 창문부품은 특별한 결합으로 모두 배 치된 하나이상의 표준창문부품들로 
이루어지거나 무로부터 쓸수 있다. 사용자정의창문부품에 기초하여 폼에 QPushButton 
창문부품들을 결합할수 있다. 

우선 머리부파일 qt/tools/designer/examples/vcr/vcr.h 를 고찰하자. 

#include <qwidget.h> 


class Vcr : public QWidget 

{ 

Q_OBJECT 

public: 

Vcr( QWidget ^parent = 0， const char *name = 0 ); 

〜 Vcr() {} 
signals: 
void rewind(); 
void play(); 
void next(); 
void stop(); 

}； 

QWidget 로부터 사용자정 의 창문부품을 파생하므로 qwidgeth 를 포함한다. 창문부품 
을 창조하는 구성자와 창문부품에 발송하는 4개 의 신호를 선언한다. 신호를 사용하므로 
Q_OBJECT 마크로를 포함한다. 

알아두기 : 신호를 리용하므로 역 시 Q_OBJECT 마크로를 포함해 야 한다. 이 마크로 
는 또한 클라스에 대한 정보는 메타객체체계를 거처서 사용된다는것과 Qt Designer 가 
창문부품에 대한 정보를 현시한다는것을 담보한다. 

실현은 간단하다. 우리가 실현하는 유일한 함수는 구성자이다. 파일의 나머지는 
include 문과 매몰된 .xpm 화상들로 구성된다. 

Vcr::Vcr( QWidget *parent, const char *name ) : QWidget( parent, name ) 

{ 

QHBoxLayout *layout = new QHBoxLayout( this ); 
layout->setMargin( 0 ); 

QPushButton *rewind = new QPushButton( QPixmap( rewind xpm ), 0, 
this, ’’vcr rewind" ); 
layout->addWidget( rewind ); 
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단추들을 배치할 QHBoxLayout 를 창조한다. 코드에서는 오직 rewind 단추만 보 
여준다. 다른 단추들은 단추의 이름과 픽스매프，신호를 제외하하고는 모두 등가하다. 
매개 단추에 대하여 적당히 매몰된 픽스매프를 넘기여 QPushButton 구성자를 호출한다. 
그다음 단추를 배치에 추가한다. 끝으로 단추의 clicked*：) 신호를 적당한 신호에 련결한다. 
clicked() 신호는 창문부품에 고유하지 않으므로 창문부품의 사용을 반영하는 신호를 발생 
하려고 한다. rewind(), play(), 기타 신호들은 창문부품에서 의미있으므로 매개 단추의 
clicked() 신호를 적당한 창문부품고유신호에 전달해야 한다. 

실현은 끝났지만 창문부품을 를파일하고 실행을 확인하기 위하여 간단한 시험기구 
를 창조한다. 시험기구는 2 개의 파일 즉 .pro 프로젝트파일과 main.cpp 파일을 요구한다. 
qt/tools/designer/examples 八 cr 八 cr.pro 프로젝트파일은 다음과 같다. 

TEMPLATE = app 
LANGUAGE = C++ 

TARGET = vcr 


CONFIG += qt wam on release 
SOURCES += vcr.cpp main.cpp 
HEADERS += vcr 上 
DBFILE = vcr.db 

qt/tools/designer/examples 八， cr/main.cpp 파일의 기 본은 다음과 같다. 
#include <qapplication.h> 

#include ，， vcr 上，， 


int main( int argc, char ** argv ) 

{ 

QApplication app( argc, argv ); 

Vcr *vcr = new Vcr; 
vcr->show(); 
return app.exec(); 

} 

사용자정 의 창문부품이 만족스럽 게 를파일되 고 실행 된다면 그것 을 Qt Designer 에 
포함할수 있다. 

기 초클라스형 판에 서 용기사용자정 의창문부품의 창조를 설 명한다. 

2) Qt Designer 에 사용자정의창문부품의 추가 

Tools | Custom | Edit Custom Widgets 를 선택 하여 Edit Custom Widgets 대화칸 
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을 연다. 

fl ) New Widget 를 선택하고 새 창문부품을 추가할 준비를 한다. 

② 클라스이름을 My Custom Widget 로부터 Vcr 로 변경한다. 

® Headerfile 행편집의 오른쪽에 있는 생략 (...) 단추를 찰칵하여 파일열기대화칸을 
연다. vcr.h 를 찾아서 선택하고 Open 을 찰칵한다. 그것이 머리부파일로서 나타난다. 

④ 도구띠에서 창문부품을 식별하는데 사용하는 픽스매프를 가지고있다면 Pixmap 
속성의 오른쪽에 있는 생략단추를 찰칵한다, (생략단추는 Properties 목록의 Value 부분 
을 선택 할 때 pixmap 나 iconSet 속성 에 의 하여 나타난다. ) 

실례에는 이 목적에 사용하는 파일 qt / tools / designer/examples 八 cr / play.xpm 이 있다. 

⑤ 창문부품의 최소감별크기를 알고있으므로 이 값들을 Size Hint 스핀칸에 넣는다. 
폭을 80( 왼쪽스핀칸에서), 높이 를 20 (오른쪽스핀칸에서 )으로 입 력한다. 

완성해 야 할 나머 지 항목들은 우리 가 창조하는 창문부품의 특성 에 의 존한다. 실 례 
로 자기 의 창문부품을 Container Widget 검 사칸에 서 검 사한 창문부품들을 포함하는데 사 
용할수 있다. Vcr 실례의 경우에 추가하려는 항목들은 그 신호들이다. 

Signals 타브를 선택한다. New Signal 단추를 찰칵하고 신호이름을 rewindO 라고 
입력한다. 다시 New Signal 을 선택하고 이번에는 play 0라고 입력한다. 같은 방법으 
로 nextO 와 stopO 신호들을 추가한다. 

우리의 실례는 처리부나 속성을 가지지 않으므로 Close 를 선택할수 있다. 새 그림 
기호가 새 창문부품을 표시 하는 Qt Designer 의 도구띠 에 나타난다. 새 폼을 창조하면 
Vcr 창문부품들을 추가하고 자기 처리부에 Vcr 의 신호를 련결할수 있다. 

자체의 처리부와 속성을 가지는 사용자정의창문부품의 삽입은 신호추가와 류사한 
방법으로 진행된다. 필요한 모든 정보는 사용자정의창문부품의 머 리부파일에 있다. 

2. 플라그인형식의 사용자정의창문부품의 작성 

여기서는 사용자정의창문부품을 쓰는 방법과 플라그인으로 사용자정의창문부품을 
매몰하는 방법을 보여준다. 틀라그인을 목적으로 하는 창문부품을 창조할 때 고려해야 
할 제한은 없다. 경험있는 Qt 프로그람작성자라면 이 항을 뛰여넘어 플라그인의 작성으 
로 직접 넘어갈수 있다. 

창문부품을 전용화하는데 플라그인수법 을 사용한다면 플라그인은 를파일시 에 Qt 
Designer 뿐아니 라 uic 에 도 유효하여 야 한다는것을 알아야 한다. 

1) 사용자정의창문부품의 작성 

보통 사용자정의창문부품은 다른 창문부품의 특수화(파생콜라스) 또는 함께 작업하 
는 창문부품들의 결합 혹은 이 두가지 수법들의 혼합물이다. 특수한 환경에서 창문부품 
들의 집합만 요구되면 그것들을 창조하는것은 가장 쉽다. 그것들을 그롭으로 선택하고 
Qt Designer 에 서 요구될 때 그것 들을 복사하여 배 치 한다. 일 반적 으로 사용자정 의 창문부 
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품은 현존창문부품이나 창문부품그롭에 새 기능을 추가하려고 할 때 창조한다. 

플라그인으로서 사용자정의창문부품을 창조할 때 고려해야 할 문제가 두가지있다. 

① Q t 의 속성체계를 사용하면 속성편집기를 통하여 창문부품환경을 구성하는 직접 
적 인 수단을 Qt Designer 사용자에게 제공한다. 

② 자기 창문부품의 공개 set 함수들을 공개처 리부로 만들어서 Qt Designer 에서 창 
문부품와의 신호-처리부련결을 처리할수 있다. 

이 절에서 간단하지만 쓸모있는 창문부품 FileChooser 를 만든다. 이것은 후에 플 
라그인으로서 Qt Designer 에서 사용할수 있게 한다. 실천에서 대부분의 사용자정의창문 
부품들은 창문부품들을 구성 하는것보다도 오히 려 기능을 추가하기 위하여 창조되므로 이 
수법을 반영하기 위 하여 Qt Designer 에서 사용하는것보다 코드로 창문부품들을 창조한 
다. FileChooser 는 QLineEdit 와 QPushButton 으로 이루어진다. QLineEdit 는 파일 
이나 등록부이름을 보관하는데 사용되며 QPushButton 은 사용자가 파일이나 등록부를 
선택할수 있는 파일대화칸을 펼치는데 사용된다. 

「一———:」 

그림 1-65. FileChooser 사용자정 의 창문부품 

이제는 자체로 이 사용자정 의창문부품을 창조할수 있다. 자체의 창문부품판을 만들 
거나 플라그인으로 하려는 다른 창문부품이 있다면 플라그인의 작성으로 넘어갈수 있다. 

- 창문부품대면부코드의 작성 

창문부품의 머 리 부파일 qt/tools/designer/examples/filechooser 八 vidg 以 통하 

여 한걸 음씩 작업한다. 

^include <qwidget.h> 

#include <qwidgetplugin.h> 


class QLineEdit; 
class QPushButton; 

우리의 창문부품은 QWidget 로부터 파생되므로 qwidgeth 머리부파일을 포함한다. 또 
한 창문부품이 건설되는 2개의 클라스들을 앞방향선언한다. 

이것은 신호나 처리부를 선언하는 콜라스들을 요구하므로 Q _ OBJECT 마크로를 포함 
한다. 0_ ENUMS 선언은 Mode 렬거를 등록하는데 쓰인다. 우리의 창문부품은 2개의 속성 
즉 사용자가 파일을 선택하는가 등록부를 선택하는가를 보관하는 mode 와 선택한 파일 
이나 등록부를 보관하는 fileName 을 가진다. 

class QT_WIDGET_PLUGIN_EXPORT FileChooser : public QWidget 

{ 
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Q_OBJECT 
Q_ENUMS( Mode ) 

Q_PROPERTY( Mode mode READ mode WRITE setMode ) 
Q_PROPERTY( QString fileName READ fileName WRITE setFileName ) 


public: 

FileChooser( QWidget *parent = 0, const char *name = 0); 
enum Mode { File, Directory }; 


QString fileName() const; 

Mode mode() const; 

구성자는 창문부품에 대하여 표준적인 방법으로 선언된다. 2개의 공개함수 즉 파일 
이름을 돌려주는 fileName() 과 방식을 돌려주는 mode() 를 선언한다. 
public slots: 

void setFileName( const QString && ); 
void setMode( Mode m ); 

signals: 

void fileNameChanged( const QString & ); 


private slots: 
void chooseFile(); 

2 개 의 set 함수를 공개처 리 부로 선언한다. setFileName() 과 setMode() 는 파일 이 름과 방 
식 을 각각 설정한다. 하나의 신호 fileNameChangedO 를 선언한다. 비 공개처 리부 
chooseFile() 는 단추를 찰칵할 때 창문부품자체 에 의 하여 호출된 다. 
private: 

QLineEdit *lineEdit; 

QPushButton ^button; 

Mode md; 


}； 

Mode 변수는 물론 QLineEdit 와 QPushButton 에로의 지적자는 비공개자료로 보 
관된 다. 
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-실현코드작성 

qt/tools/designer/examples/filechooser/widget/filechooser.cpp 에 있는 실현을 통하여 한걸음 
씩 작업하자. 

FileChooser: : FileChooser( QWidget ^parent, const char *name ) 

: QWidget( parent, name ), md( File ) 

{ 

구성자는 그 상위클라스 QWidget 에로 parent 와 name 을 넘기며 또한 비공개방식 
자료 md 를 File 방식으로 초기화한다. 

QHBoxLayout *layout = new QHBoxLayout( this ); 
layout->setMargin( 0 ); 

lineEdit = new QLineEdit( this, "filechooser lineedit” ); 
layout->addWidget( lineEdit ); 

수평 칸배 치 ( QHBoxLayout ) 를 창조하는것 으로 시 작하여 하나의 QLineEdit 를 추 
가하고 거기에 하나의 QPushButton 을 추가한다. 

connect( lineEdit, SIGNAL( textChanged( const QString & ) ), 
this, SIGNAL( fileNameChanged( const QString & ) ) ); 

button = new QPushButton( this, "filechooser button" ); 
button->setFixedWidth( button->fontMetrics().width( ’’ ... " ) ); 
layout->addWidget( button ); 

connect( button, SIGNAL( clicked() ), this, SLOT( chooseFile() ) ); 

lineEdit 의 textChanged() 신호를 사용자정의창문부품의 fileNameChanged() 신호에 련결 
한다. 이것은 사용자가 QLineEdit 의 본문을 변경한다면 사용자정의창문부품의 자기 신 
호를 통하여 이 사실이 전달된다는것을 담보한다. 단추의 clicked() 신호는 사용자에게 적 
당한 대 화칸을 펼 치 여 과일 이 나 등록부를 선택하는 사용자정 의 창문부품의 chooseFileO 처 
리부에 련결한다. 

setFocusProxy( lineEdit ); 

} 

lineEdit 를 사용자정의창문부품용의 초점대리로서 설정한다. 이것은 창문부품에 초 
점이 주어질 때 초점이 실제로 lineEdit 로 간다는것을 의미한다. 
void FileChooser::setFileName( const QString &fn ) 

{ 
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lineEdit->setText( fn ); 


QString FileChooser: : fileName() const 

{ 

return lineEdit->text(); 

} 

seffileName() 함수는 QLineEdit 에서 파일이름을 설정하고 fileNameO 함수는 
QLineEdit 로부터 파일 이 름을 돌려 준다. 마찬가지 로 setMode() 와 mode() 함수들을 설정하 
고 주어진 방식을 돌려준다. 

void FileChooser: : chooseFile() 

{ 

QString fii; 

if ( mode() == File ) 

fn = QFileDialog: : getOpenFileName( lineEdit->text(), QString::null,this); 
else 

fn = QFileDialog::getExistingDirectory( lineEdit->text(), this ); 


if ( !fii.isEmpty() ) { 
lineEdit->setText( fii ); 
emit fileNameChanged( fn ); 

} 

} 

chooseFile() 이 호출될 때 방식에 따라 사용자에게 파일 혹은 등록부대 화칸을 표시 한 
다. 사용자가 파일이나 등록부를 선택하면 QLineEdit 는 선택된 파일이나 등록부로 갱 
신되고 fileNameChanged() 신호가 발생된다. 

비록 2 개의 파일이 FileChooser 창문부품의 실현을 완성한다 할지라도 시험기구를 작성 
하여 창문부품을 플라그인으로 넣 기전에 기 대 한대 로 동작하는가를 검 사하는것 이 좋다. 

- 실현의 시험 

우리 의 사용자정 의창문부품을 실 행하게 하는 기 본시 험 기구를 제 공한다. 시 험 기구는 
두개의 파일 즉 FileChooser 를 포함하는 main.cpp 와 Makefile 을 포함하는 .pro 파일을 
요구한다. 아래에 qt/tools/designer/examples/filechooser/widget/main.cpp 가 있 다. 

#include <qapplication.h> 

^include ’’filechooser.h" 


122 






int main( int argc, char ** argv ) 

{ 

QApplication a( argc, argv ); 

FileChooser *fc = new FileChooser; 

fc->show(); 

return a.exec(); 

} 

또한 아래에 qt/tools/designer/examples/filechooser/widget/filechooser.pro^l- 있 다. 
TEMPLATE = app 
LANGUAGE = C++ 

TARGET 늦 filechooser 


SOURCES += filechooser.cpp main.cpp 

HEADERS += filechooser .h 

CONFIG += qt wam on release 

DBFILE _ filechooser.db 

DEFINES += FILECHOOSER_IS_WIDGET 

qmake 를 사용하여 다음과 같이 makefile 을 창조한다. 즉 qmake -o Makefile 
filechooser.pro 이 다. 그다음 시 험 기 구를 make 하고 실 행 하여 새 창문부품을 시 험 한다. 사 
용자정 의 창문부품이 튼튼하고 필요한 동작을 한다는것 이 확인되 면 그것 을 플라그인으로 
매몰할수 있다. 

公 、플라그인의 작성 

Qt Plugins 은 Qt 응용프로그람에 자체로 포함한 쏘프트웨어부분품들을 제공하는데 
사용될수 있다. 야는 현재 5가지 종류의 플라그인 즉 codecs 와 image formats , 
database drivers , styles , custom widgets 창문부품의 창조를 지원한다. 여기서는 
filechooser 사용자정 의 창문부품을 Qt Designer 사용자정 의 창문부품플라그인 으로 변환하 
는 방법을 설명한다. 

Qt Designer 사용자정의창문부품플라그인은 항상 QwidgetPlugin 으로부터 파생된 
다. 필요한 코드량은 최소이다. 

자기의 플라그인을 만들기 위하여서는 실례 plugin.h 과 plugin.cpp 파일들을 복사하여 
CustomWidgetPlugin 을 자기의 창문부품플라그인실현클라스에 사용하려는 이름으로 
변경하는것 부터 시 작하는것 이 가장 편리하다. 클라스이 름변경후에 다른 변경 이 요구되 지 
않는다 하더라도 머리부파일에 대한 소개를 다음에 제공한다. 실현파일은 간단한 변경 
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대체로는 클라스이름변경을 요구한다. 매개 함수를 차례로 개괄하고 무엇을 해야 하는가 
를 설명한다. 

- CustomWidgetPlugin 실현 

우리 의 플라그인클라스를 사용하여 사용자정 의창문부품들을 은폐하려 고 하므로 머 
리부파일을 plugin . h , 플라그인들라스를 CustomWidgetPlugin 으로 한다. 전체머리부파 
일을 제시하여 필요한 실현의 리용범위를 암시한다. 대부분의 함수들은 여러행의 코드를 
요구한다. 

// qt/tools/designer/examples/filechooser/plugin /마 부터 발취 

#include <qwidgetplugin.h> 


class CustomWidgetPlugin : public QWidgetPlugin 

{ 

public: 

CustomWidgetPlugin(); 


QStringList keys() const; 

QWidget* create( const QString &classname, QWidget* parent = 0, 
const char* name = 0 ); 

QString group( const QString& ) const; 

QlconSet iconSet( const QString& ) const; 

QString includeFile( const QString& ) const; 

QString toolTip( const QString& ) const; 

QString whatsThis( const QString& ) const; 
bool isContainer( const QString& ) const; 

}； 

- QWidgetPlugin 함수 

우리의 플라그인 .cpp 파일을 복사하고 CustomWidgetPlugin 의 모든 실현을 자기 
창문부품플라그인실현에 사용하려는 이름으로 변경하여 자체의 플라그인 .cpp 파일을 창 
조하자. 다른 변경은 전용조종요소 FileChooser 의 이름을 자기 전용조종요소의 이름으 
로 단순히 교체하는것이다. 자기의 플라그인실현에 하나이상의 전용조종요소가 있다면 
여 분의 else if 절 을 추가할수 있 다. 

이제 구성자를 고찰하자. 

CustomWidgetPlugin::CustomWidgetPlugin() 

{ 
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} 

구성자는 아무것도 하지 않는다 . 자체의 창문부품플라그인실현에 사용하려는 콜라 
스이름으로 우리의것을 단순히 복사한다 . 

해체자는 필요없다 . 

- keys 함수 

QStringList CustomWidgetPlugin: : keys() const 

{ 

QStringList list; 
list « "FileChooser"; 
return list; 

} 

플라그인실현에 은폐하려는 매개 창문부품클라스에 대하여 들라스를 식별할수 있는 
건을 제공해야 한다 . 이 건은 자기 들라스의 이름이여야 하므로 실례에서는 단일건 
FileChooser 을 추가한다 . 

- create() 함수 

QWidget* CustomWidgetPlugin: :create( const QString &key, 

QWidget* parent, const char* name ) 

{ 

if ( key =- "FileChooser" ) 

return new FileChooser( parent, name ); 
return 0; 

} 

이 함수에서는 요구되는 콜라스의 실례를 창조하고 새로 창조한 창문부품에로의 
QWidget 지 적 자를 돌려 준다 . 들라스이 름과 특성이 름을 변경 하여 이 함수를 복사하고 방 
금 여기서 수행한것처럼 자기 창문부품의 실례를 창조한다 . 

- includeFile() 함수 

QString CustomWidgetPlugin::includeFile( const QString& feature ) const 

{ 

if ( feature == "FileChooser" ) 
return "filechooser.h"; 
return QString: : null; 

} 

이 함수는 사용자정의창문부품용의 머리부파일이름을 돌려준다 . 이 함수를 콜라스 
이름과 건，머리부파일이름을 자기 사용자정의창문부품에 맞게 변경하여 복사한다 . 
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groupO 와 iconSet(), toolTip(), whatsThis () 함수들 
QString CustomWidgetPlugin: : group( const QString& feature ) const 
{ 

if ( feature = "FileChooser" ) 
return "Input"; 
return QString: :null; 

} 


QlconSet CustomWidgetPlugin: : iconSet( const QString& ) const 

{ 

return QIconSet( QPixmap( filechooser 一 pixmap ) ); 

} 

QString CustomWidgetPlugin: : includeFile( const QString& feature ) const 

{ 

if ( feature = "FileChooser" ) 
return "filechooser.h"; 
return QString: :null; 

} 


QString CustomWidgetPlugin: : toolTip( const QString& feature ) const 

{ 

if ( feature = "FileChooser" ) 
return "File Chooser Widget"; 
return QString: :null; 

} 

QString CustomWidgetPlugin: : whatsThis( const QString& feature ) const 

{ 

if ( feature = "FileChooser" ) 

return "A widget to choose a file or directory"; 
return QString: :null; 

} 

group () 함수를 사용하여 어느 Qt Designer 도구띠 그룹이 이 사용자정의 창문부품을 
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포함하는가를 식 별한다 . 사용하지 않는 이름을 리용하면 Qt Designer 는 주어 진 이름을 
가지는 새 도구띠그룹을 창조한다 . 이 함수를 클라스이름 , 건과 그룹이름을 자기의 창문 
부품플라그인실 현에 적 합하게 변경 한다 . 

iconSet() 함수는 도구띠 에 서 사용자정 의 창문부품을 표시하는데 사용하는 픽 스매 프를 
돌려준다 . toolTipO 함수는 도구암시 본문을 돌려주고 whatsThis() 함수는 Whats This 본문을 
돌려준다 . 이 함수들을 각각 클라스이름과 건，돌려주는 문자렬을 자기의 창문부품플라 
그인실현에 적 합하게 변경하여 복사한다 . 

- isContainer() 함수 

bool CustomWidgetPlugin::isContainer( const QString& ) const 

{ 

return FALSE; 

} 

이 함수에서 클라스이름을 자기의 창문부품플라그인실현에 적합하게 변경하여 복사 
한다 . 자기의 사용자정의창문부품이 다른 창문부품(가령 QFrame) 을 포함할수 있다면 
TRUE 를 돌려 주어야 한다 . 다른 창문부품(가령 QPushButton) 을 포함하면 안되는 경 
우에 FALSE 를 돌려준다 . 

- Q_EXPORT_PLUGIN macro 마크로 
Q_EXPORT_PLUGIN( CustomWidgetPlugin ) 

이 마크로는 모둘을 플라그인으로서 식별한다 . 다른 모든 코드는 단지 련관된 대면 
부를 실현한다 . 즉 유효하게 하려는 클라스들을 포함한다 . 

이 마크로는 자기 의 플라그인에 한번 나타나야 한다 . 그것 은 자기 의플라그인의 클 
라스이름으로 변경된 클라스이름으로 복사되여야 한다 . 

창문부품플라그인실현에 포함 한 매개 창문부품은 플라그인실현이 제공 하는 콜라스 
로 된다 . 플라그인실현에 포함할수 있는 들라스의 수에는 제한이 없다 . 

-프로젝트 파일 

플라그인 용 프로젝 트파일은 응용프로그람의 프로젝 트파일 과 좀 다르지 만 대 부분의 
경 우에 HEADERS 와 SOURCES 행 만 변경하여 프로젝 트파일을 사용할수 있다 . 

TEMPLATE = lib 

LANGUAGE * C++ 

TARGET = filechooser 

SOURCES += plugin.cpp ../widget/filechooser.cpp 

HEADERS += plugin.h . ./widget/filechooser.h 

DESTDIR 헤 ../../../../. ./plugins/designer 
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target.pa 仕 i=$$plugins.pa 仕 i 


INSTALLS target 

CONFIG 총 qt wam_on release plugin 

INCLUDEPATH += $$QT_SOURCE_TREE/tools/designer/interfaces 

DBFILE = plugin.db 

qt/tools/designer/examples/filechooser/plugin/plugin.pro 

HEADERS 행 을 변경하여 자기 의플라그인의 머 리 부파일과 자기 의 창문부품용 머 리부 
파일 을 표시한다 . SOURCES 행 도 등가하게 변경 한다 . qmake 로 Makefile 을 창조하고 프로 
젝트를 make 하면 플라그인이 창조되고 Qt Designer 가 발견할수 있는 등록부에 배치된 
다 . 다음번에 Qt Designer 를 실행 할 때 새 로운 플라그인을 발견하고 자동적 으로 적재 하 
며 지정된 도구띠에 그림기호가 표시된다 . 

- 창문부품플라그인의 리용 

플라그인이 일단 를파일되였으면 그것은 자동적으로 발견되고 다음번에 Qt 
Designer 를 실행할 때 Qt Designer 에 의하여 적재된다 . 자기의 사용자정의창문부품을 
다른 창문부품처 럼 사용한다 . 

프로젝트의 다른 곳에서 그 플라그인을 사용하려면 프로젝트에 적당한 행을 추가하 
여 거기에 련결할수 있다 . 실례로 프로젝트의 .pro 파일에 다음과 같이 추가한다 . 

LIBS += filechooser.lib 

응용프로그람을 배포하려고 한다면 실행파일과 함께 번역된 플라그인을 포함한다 . 
Qt 설 치등록부의 plugins/widgets 보조등록부에 플라그인을 설 치한다 . 표준플라그인경 로를 
사용한다면 플라그인에 사용하려는 경로를 설 치과정 에 결정 하고 응용프로그람이 실행시 
에 읽 어들이도록 그 경로를 (가령 QSettings 를 사용하여 ) 보관한다 . 그다음 응용프로그 
람은 이 경로를 가지고 QApplication::addUbraryPa 比 i() 를 호출할수 있으며 자기의 
플라그인을 응용프로그람에 사용할수 있다 . 경로의 마지막 부분 즉 styles, widgets 등은 
변경할수 없 다 . 

- 플라그인과 스레드응용프로그람 

스레 드화된 Qt 서 고에 서 사용하려 는 플라그인(어 차피 플라그인자체 가 스레 드를 사용 
한다.)을 건설하려고 한다면 스레드환경을 사용해야 한다 . 특히 스레드화된 Qt 서고를 
사용해 야 하며 그 서고를 가지고 Qt Designer 를 건설해야 한다 . 자기 플라그인용 .pro 
파일에는 다음의 행을 포함해 야 한다 . 

CONFIG += thread 

응용프로그람에 표준 Qt 서고와 스레드화된 Qt 서고를 섞지 말아야 한다 . 응용프로그 
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람이 스레드화된 Qt 서고를 사용한다면 표준 Qt 서고와 련결하지 말아야 한다. 표준 Qt 서 
고를 동적 으로 적재하지 말아야 하고 또한 다른 서 고 실례 로 표준 Qt 서 고에 의존하는 플 
라그인을 동적으로 적재하지 말아야 한다. 일부 체계에서 스레드화서고와 비스레드화서 
고 또는 플라그인의 혼합은 Qt 서 고에 서 사용된 정 적자료를 못쓰게 만든다. 

제7절. 자료기지응용프로그람의 작성 

이 절에서는 Qt Designer 안으로부터 (과의 자료인식 (data-aware) 창문부품을 사용 
하는 방법을 보여준다. 여기서는 QDataTable (표)와 QDataBrowser (폼)에서 
INSERT 와 UPDATE, DELETE 를 보여 준다. 또한 주-세 부관계 와 구멍 내 기 (drilldown) 
의 코드작성 방법 을 보여준다. 여 기서는 간단한 외부열쇠 조종수법 을 제시하며 더 복잡한 
수법은 직결 SQL 모둘문서에서 보여준다. 

이 창문부품들을 사용하여 실례를 실행하거 나 자체의 응용프로그람을 창조하려 고 
한다면 SQL 자료기지와 자료기지에 련결할수 있는 Qt 자료기지 구동프로그람을 호출해야 
한다. Qt^> 지원하는 구동프로그람은 QODBC3 (Open Database Connectivity) , 
QOCI8 (Oracle), QPSQL7 (PostgreSQL 6 과 7) 그리 고 QMYSQL3 (MySQL) 이 다. 

Qt 자료인식창문부품들을 사용하여 SQL 을 쓰러고 하지 않고 SQL 자료기지에서 자료를 
열람 및 편집할수 있더라도 SQL 에 대한 기본리해가 강하게 권고된다. SELECT 와 INSERT, 
UPDATE, DELETE 문을 알고있는것으로 가정한다. 또한 주열쇠와 외부열쇠의 표준개념을 알 
고있는것 으로 가정 하자. SQL 자료기 지 를 론하는 표준서 적 은 문헌 이 를 참고하시 오. 

다음에 book 자료기 지 응용프로그람의 창조를 설명 한다. 응용프로그람은 in-place 레 
코드편집을 포함하는 QDataTable 들의 사용방법과 QDataTable 들사이의 주-세부관계 
를 설정하는 방법을 보여준다. 또한 QDataTable 로부터 다른 창문부품 례를 들면 
QDataBrowser 혹은 QDataView 를 펼치는 방법과 QDataBrowser 에서 레코드편집을 
처 리 하는 방법을 설명 한다. 파생클라스작성 이 항상 더 고급한 조종에 사용할수 있다하더 
라도 Qt Designer 에서 직 접 클라스들로부터 대 량적 인 기능을 사용할수 있 다. Book 실례 
를 건설하려고 한다면 자료기지의 실례스키마를 창조해 야 한다. 
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그림 1-66. Book 응용프로그람 

- 실례스키마 

이 절의 모든 실례들은 qt/tools/designer/examples/book/book.sql 파일에서 정의되는 표와 보 
기，레 코드를 사용한다. 이 파일은 PostgreSQL 6과 PostgreSQL 7에 의 하여 시 험 하였 다. 
이 파일에서 SQL 을 수정하여 차기의 체계에서 실례자료기지를 다시 창조할수 있다. 

스키 마 CREATE TABLE 문 

CREATE TABLE author ( id integer primary key, forename varchar(40), 
surname varchar(40) ); 

CREATE TABLE book ( id integer primary key, title varchar(40), 
price numeric(10,2), authorid integer, notes varchar(255) ); 

CREATE TABLE sequence ( tablename varchar(lO), sequence numeric); 
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book 표는 실례의 목적에 맞게 간소화된다. 도서를 단일한 저자 ( authorid ) 와 련결 
할수 있으며 ISBN 마당이 없다. Sequence 표는 실례표들에 대한 유일색 인값을 생성하는 
데 사용된다. SQL 자료기지들은 흔히 더 최적인 풀이로 되는데 아주 류사한 렬(실례로 
CREATE SEQUENCE 지 령 의 사용)을 창조하기 위한 자기의 방법 을 제 공한다. 이 식을 위 
하여 실례들은 대부분의 SQL 자료기지들과 작업하는 sequence 표를 사용한다. 

1. 자료기지련결의 설정 

우리가 고려해야 하는 자료기지련결의 두가지 견해가 있다. 첫째로, Qt Designer 
자체에서 사용하려고 하는 련결이 다. 둘째로，우리가 창조하는 응용프로그람에서 사용하 
려고 하는 련결이다. 

1) Qt Designer 의 련결설정 



그림 1-67. Edit 자료기 지련결대화칸 

차림표띠에서 Project | Database Connec 切 ons 를 선택 한다. Edit Database 
Connections 대 화칸이 나타난다. New Connection 을 선택 한다. 단일 자료기 지 를 사용하 
는 응용프로그람에 대하여 기정련결이름 ( default ) 을 사용하는것이 가장 편리하다. 1개이 
상의 자료기지를 사용한다면 매개가 유일한 이름으로 주어져야 한다. 구동프로그람은 
Driver 복합칸으로부터 선택 되 여 야 한다. 자료기 지 이 름은 Database Name 복합칸에 서 사 
용하거 나 입 력 해 야 한다. 자료기 지이 름，사용자이 름, 암호, 주를퓨터이 름과 포구는 자료 
기 지 체계 관리 자에 의 하여 제 공되 여 야 한다. Connection 정 보를 완성 되 였을 때 Connect 
를 선택한다. 련결이 이루어지면 련결이름이 대화칸의 왼쪽 목록칸에 나타난다. 이제는 
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대화칸을 닫을수 있으며 련결설정은 그것들을 변경하거나 삭제하거나 Qt Designer 로부 
터 완료할 때까지 효력을 발휘 한다 . 

경고 : 현존하는 SQLite 자료기지를 사용한다면 Database Name 마당에 지정하는 이 
름이 현존자료기지파일과 같지 않아야 한다는것을 담보해 야 한다 . Qt Designer 는 자료 
기지용으로 주어지는 이름을 리용하여 환경파일을 창조하고 같은 이름의 현존파일을 다 
시 써넣는다 . 

Qt Designer 는 qmake 프로젝 트파일 에 자료기 지 련결설정 을 기 억 할수 있다 . 새 프로 
젝트를 창조한다 . 실례로 File | New 를 선택하고 C++ Project 그림기호를 선택하여 
Project Settings 대화칸을 연다 . 생략단추를 찰칵하여 Save As 대화칸을 열고 프로젝트 
의 등록부로 이행한다 . (필요하다면 생성한다 .) 프로젝트의 등록부안에 있는가 확인하고 
프로젝 트이 름을 book, pro 라고 입 력 한다 . Save 단추를 찰칵하여 Project Settings 대 화칸 
로 돌아와서 OK 를 찰칵한다 . 다음번에 Qt Designer 가 기동할 때 개별적인 .ui 파일들을 
열지 않고 . pro 프로젝트파일을 열면 Qt Designer 는 자동적으로 프로젝트의 련결설정을 
재적재한다 . 련결을 능동으로 하기 위하여 Project | Database Connections 을 선택한다 . 
프로젝트파일에 이미 보관된 련결들은 왼쪽 목록칸에 표시된다 . 사용하려는 련결을 선택 
하고 Connect 를 선택한다 . 이제는 이 련결을 사용하며 실례로 QDataTable 들을 미리 
보기하는데 사용한다 . 또한 프로젝트파일의 열기는 Qt Designer 가 프로젝트와 련결된 
폼들의 목록을 Project Overview 창문으로 적재 하게 한다 . 앞으로의 설명 에서는 프로젝 
트파일들을 사용하며 항상 Qt Designer 에서 작업할 때 사용할수 있는 련결이 있도록 하 
기 위 하여 Connect 를 선택한것 으로 가정 한다 . 

2) 응용프로그람을 위한 련결의 설정 

창조한 응용프로그람들은 SQL 자료기지 에 대 한 자체의 련결을 만들어 야 한다 . 자기 
코드에 서 기 초로 사용할수 있는 실 례함수 createConnections() 를 제 공한다 . 

bool createConnections() 

{ 

// create the default database connection 

QSqlDatabase *defaultDB = QSqlDatabase: : addDatabase( "QPSQL7" ); 

if ( ! defaultDB ) { 

qWaming( "Failed to connect to driver" ); 
return FALSE; 

} 

defaul 仕 ) B->setDatabaseName( "book" ); 

defaultDB->setUserName( "bookuser" ); 

defaultDB->setPassword( "bookpw" ); 
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defaultDB->setHostName( "bookhost” ); 
if ( ! defaultDB->open() ) { 

qWaming( "Failed to open books database: ’’ + 
defaultDB->lastError().driverText() ); 
qWaming( defaultDB->lastError().databaseText() ); 
return FALSE; 

} 

return TRUE; 

} 

사용하려는 구동프로그람의 이름을 넘기여 addDatabase() 를 호출한다 . 그다음 set 함 
수들을 호출하여 련결정보를 설정한다 . 끝으로 련결을 열려고 시도한다 . 성공하면 
TRUE 를 돌려주며 그렇지 않으면 오유정보를 출력하고 FALSE 을 돌려준다 . 
(qt/tools/designer/examples/book/bookl/main.cpp 에 서 발취 .) 
int main( int argc, char *argv[] ) 

{ 

QApplication app( argc, argv ); 

if ( ! createConnections() ) 
return 1; 

BookForm bookForm; 

app.setMainWidget( &bookForm ); 

bookForm. show(); 

return app.exec(); 

} 

이 절 에 서 제 시 한 모든 실례 들은 main , cpp 파일 에 서 QApplication 객 체 를 창조한 
다음 createConnectionsO 를 호출하여 기정 련결을 사용할수 있게 만든다 . 여 러개의 자료기 
지에 련결하려고 한다면 addDatabase() 의 2 인수형식을 사용하며 거기에 구동프로그람의 
이름과 유일식별자를 넘긴다 . 

자료기 지련결 에 대 한 참고를 유지할 필 요는 없 다 . 단일 한 자료기 지련결 을 사용한다 
면 이것은 기정 련결으로 되 고 자료기지함수들은 이 련결을 자동적 으로 사용한다 . 우리는 
항상 QSqmatabase :: database() 를 호출하여 임의의 련결에 로의 지적 자를 얻 을수 있다 . 
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Qt Designer 를 사용하여 main.cpp 파일 을 창조한다면 이 파일은 createConnections() 를 
포함하지 않는다 . 그것 이 자료기 지련결 에 사용자이 름과 암호를 요구하기 때 문에 이 기 능 
을 포함하지 않으며 이것들을 우의 단순한 실례함수와 다르게 취 급하는것 을 좋아할수 있 
다 . 결국 Qt Designer 에서 정 확히 미 리 보기 되는 응용프로그람은 자기의 자료기지 련결함 
수를 실현하지 않는한 실행되지 않는다 . 

2. QDataTable 의 리용 

QDataTable 을 임의의 픔에 배치하여 자료기지표와 보기의 열람을 제공할수 있다 . 
QDataTable 은 in-place 에 서 가령 세 포자체안에 서 레 코드들을 갱 신하거 나 삭제 하는데 
사용될수 있다 . QDataTable 을 경유한 레코드삽입은 보통 실례를 위한 주열쇠를 생성하 
거나 기정값을 제공할수 있도록 primelnsertO 신호에로의 련결을 요구한다 . 픔보기를 사용 
하여(여 러개의 표과 보기 에서 자료를 결합하여 ) 레코드를 제시하려면 여 러개의 
QDataBrowser 와 QDataView 를 사용할수도 있다 . 

1) 자료기지표의 고속보기 

다음의 실례는 이 절의 다른 모든 실례들처럼 프로젝트이름 book 를 가지며 
book, sql 스크립트에 의해 만들어지는 자료기지를 사용한다 . 이 절에 따라 book 응용프로 
그람을 한걸음씩 건설 한다 . 초기 에 보여 준 qiytools/designer/examples/book/bookl/main.cpp 파일 
을 창조하거 나 복사한다 . 첫번째 실례 를 위한 프로젝 트파일은 

qt/tools/designer/examples/book/book 1/book.pro°1 ^1-. 새 로운 프로젝 트를 File | New 를 선택 하는 
것 으로 시 작하고 C++Project 그림 기 호를 선택 하여 Project Settings 대 화칸을 펼친 다 . 생 
략단추를 찰칵하여 Save As 대화칸을 열고 프로젝트의 등록부(필요하다면 만든다.)로 이 
행한다 . 프로젝트의 등록부에 있는것을 확인하고 프로젝트이름을 book.pro 라고 입력한다 . 
Save 단추를 찰칵하여 Project Set 仕 ngs 대화칸로 돌아와서 OK 를 찰칵한다 . 이제는 
Project | Database Connections 를 선택 한다 . 자기의 자료기지 에 적 당한 련결정보를 기 입 
하고 Connect 를 찰칵한다 . 련결이름이 왼쪽 목록칸에 나타나야 한다.대화칸을 닫는다 . 

그러면 우리 자료기지표중의 하나에 련결되는 QDataTable 을 가진 새로운 폼을 창 
조한다 . 

FilelNew 를 선택한다 . New File 대화칸은 선택가능한 많은 폼형판을 제시한다 . 
Dialog 폼을 선택 하고 OK 를 찰칵한다 . 지 금 File|Save 를 선택한다 . 파일 이 름을 book.ui 
라고 부론다 . 

- QDataTable 의 설정 

폼에 QDataTable 창문부품을 배치하기 위 하여 Tools | Views | DataTable 을 선택 하거 
나 DataTable 도구띠 단추를 찰칵한다 . 폼을 선택 하면 Data Table Wizard 가 나타난다 . 

4) Database Connection and Table 위자드페 지는 만일 존재 하지 않으면 련결을 
설정 하고 QDataTable 을 위한 표 또는 보기를 선택하는데 사용된다 . 
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왼쪽 Database Connection 목록칸에서 사용하려는 련결 례를 들면 ( default ) 를 
선택한다. 사용가능한 표와 보기는 오른쪽 Table 목록칸에 나타난다. au 比 ior 표를 선택 
하고 Next 단추를 찰칵한다. 

② Displayed Fields 위자드페 지는 QDataTable 에서 표시 할 마당들과 그 순서를 
선택하는 수단을 제공한다. 기정으로 주열쇠(만일 있으면)이외의 모든 마당은 
Displayed Fields 목록칸에 있 다. 왼쪽과 오른쪽의 푸른 화살단추는 Displayed Fields 
와 Available Fields 목록칸사이에서 마당을 이동하는데 사용될수 있다. 푸른색의 올리 
와 내 리화살단추는 표시된 마당의 표시순서를 선택하는데 사용된다. 

기정설정을 요구하므로 단지 Next 단추를 찰칵한다. 

® Table Properties 위 자드페 지는 QDataTable 의 자료기지 관련속성을 호출하는데 
편리를 제공한다. 

Confirm Deletes 검사칸이 선택되였는가 확인하고 Next 단추를 찰칵한다. 

④ SQL 위자드페지는 QDataTable 의 Filter 와 Sort 속성들을 설정하는데 사용된다. 
Filter 는 SQL WHERE 절 이다(단어 WHERE 없이). 례를 들면 단지 성 이 P 로 시 작되는 
저 자를 표시 하기 위 하여 서 는 title LIKE ’ P %’ 를 입 력한다. 려파기 를 비 워 놓는다. 
Available Fields 목록칸은 모든 마당을 표시 한다. Sort By 목록칸은 QDataTable 을 분 
류하려 는 마당들과 분류방법 (ASCending 혹은 DESCending ) 을 표시 한다. 좌우의 푸 
른 화살은 2개의 목록칸사이에서 마당을 이동하는데 사용된다. 우아래의 푸른 화살은 
Sort By 목록칸안에서 마당을 상하로 움직 인다. ASC 또는 DESC 설정은 sort order 도구 
띠단추로 교체 된 다. 

Sort By 목록칸으로 성과 이 름마당을 이동하고 Next 를 찰칵한다. 

⑤ Finish 위자드폐지는 되돌아와서 임의의 설정을 변경할수 있는 기회를 준다. 
QDataTable 의 속성을 통하여 그것들을 후에 변경할수 있으므로 위자드를 완료할수 있다. 

Finish 를 선택한다. 

표는 기정렬이름으로 표식된 렬들을 가지는 폼에 나타난다. 설정을 변경하려면 그 
대부분은 속성창문에서 사용할수 있다. 현시이름， 그것들이 기초하는 마당과 렬들의 표 
시순서는 QDataTable 을 오른쪽 단추로 누르고 Edit 를 왼쪽 단추로 눌러서 표시되는 
Edit Table 대화칸(후에 설명)를 사용하여 변경할수 있다. 

- 폼의 배 치 

폼을 선택 하고 Lay Out Vertically 도구띠 단추를 찰칵한다. 지 금 
Preview | Preview Form 을 선택 하여 종을 실행 하면 표는 모든 레 코드를 자동적 으로 표 
시한다. 

실행가능한 응용프로그람에서 생성한 폼으로 절환하기 위하여서는 main . cpp 파일을 
프로젝트파일에 추가하고 프로젝트를 구축해야 한다. 또한 일부 이름을 변경하여 리해하 
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기 쉽게 해 야 한다. 

t ) 픔을 선택 하고 이름을 BookForm 토，제목을 Book 로 변경 한다. QDataTable 을 
선택하고 이름을 Au 比 lorDataTable 로 변경한다. 

② File | Save All 을 선택 한다. 

③ 평본문편집기에서 프로젝트파일 실례로 book.pro 를 열고 파일의 끝에 다음의 
행 SOURCES += main.cpp 을 추가한다. 

④ qmake 를 실행하여 make 파일을 생성한다. 실례로 qmake -o Makefile 
book . pro . 그다음 book 프로그람을 구축하고 실행한다. 

이 실례는 QDataTable 을 사용하여 자료기지의 표나 보기의 내용을 보여주는것이 
얼마나 쉬운가를 보여준다. 방금 건설한 응용프로그람을 사용하여 저자레코드를 갱신하 
고 삭제할수 있다. 그 다음의 실례 에서 삽입과 주-세부관계설정，구멍 내기와 외부열쇠검 
색을 설명 한다. 

- 외부열쇠에 대한 알아두기 

대부분의 관계형 자료기지 에서 표는 다른 표에로의 외부열쇠들로 되 여있는 마당을 
포함한다. book 자료기지실례에서 book 표의 authorid 는 저자표에로의 외부열쇠이다. 
말단사용자에게 폼을 제시할 때 보통 외부열쇠 그 자체가 아니라 그와 련결된 본문을 보 
려고 한다. 마찬가지로 도서정보를 보여줄 때 저자 ID 가 아니 라 저자의 이름을 표시하려 
고 한다. 많은 자료기지들에서 이것은 보기에 의해 이루어질수 있다. 

2) QDataTable 에 레코드의 삽입 

관계형자료기지에 대한 레코드삽입은 보통 표에서 레코드를 유일하게 식별하는 주 
열쇠값의 생성을 요구한다. 또한 자주 어떤 마당용의 기정값을 창조하여 사용자의 일감 
을 줄이려고 한다. QDataTable 의 primelnsertO 신호를 받아들이는 처리부를 만들고 
유일한 주열쇠를 가지는 QSqlRecord 삽입완충기를 구성한다. 

建) Edit|Slots 를 선택하여 Edit Functions 대화칸을 연다. New Function 을 선택 
한 다음 Function Properties 의 Function 행 편집 칸에 처 리부이 름이 름 
primelnsertAu 比 ior ( QSqlRecord *) 를 입력한다. OKI 찰칵한다. 

逐) Connect Signals/Slots 도구띠 단추를 찰칵하고 Au 比 lorDataTable 을 선택 하고 
폼으로 끌고가서 마우스를 놓는다. 그러면 Edit Connections 대화칸이 나타난다. 
primelnsertO 신호와 primelnsertAuttiorO 처리부를 각각 선택하고 련결을 만든다. 
OK 를 찰칵한다. 

:遠> Object Explorer 창문의 Members 타브를 선택한다. (필요하다면 
Window | Views | Object Explorer 를 선택하여 창문을 표시한다.) 

primeInsertAu 1 ;horO 처 리부를 선택 하면 편집기 창문이 나타난다. 

受) BookForm : : primeInsertAuthor () 처 리 부를 변경 하여 파라메 터 이 름을 지 정 하고 
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필요한 작용을 처 리한다. 

void BookForm : : primeInsertAuthor ( QSqlRecord * buffer ) 

{ 

QSqlQuery query ; 

query . exec ( "UPDATE sequence SET sequence = sequence + 1 " 

"WHERE tablename =, author ';" ); 

query . exec( M SELECT sequence FROM sequence WHERE tablename =' author ';; 

if ( query . next () ) { 

buffer -> setValue ( " id ", query . value ( 0 ) ); 

} 

} 

QSqlQuery 객체는 저자표에 대한 유일 한 sequence 번호를 증가시 키고 얻 는데 사 
용된다. 신호는 우리에게 삽입완충기에의 지적자를 넘기였고 그다음 우리가 얻은 값(즉 
다음 순서렬 번호) 을 완충기 의 ID 마당에 넣 었 다. (흔히 SQL 자료기 지 가 자연적 인 순서렬 
함수를 지원한다. 여기에서 사용되는 방법은 생산체계에 잘 어울리지 않고 실례의 목적 
을 위 해서 뿐이 다. 코드에서 유일 한 열쇠 를 생성하는 방법 에 대 한 자세 한 내 용은 자기 자 
료기지의 참고문서를 참고하시오. 많은 경우에 자료기지는 그것들을 자동적으로 생성할 
수 있다. 또는 자료기지는 순서렬을 다루기 위하여 특별한 구문을 제공할수도 있다.) 

응용프로그람을 다시 건설하면 UPDATE 와 DELETE 뿐아니라 INSERT 를 지원한다. 
간단히 기 정 값(실 례 로 필 요하다면 날자마당에 오늘의 날자)을 삽입 하기 위한 보충적 인 
코드를 추가할수 있다. 

열 람은 레 코드를 선택 하고 화살표건을 사용하여 진행 된 다. 레 코드가 강조표시되 면 
그것을 편집할수 있다. Insert 건을 눌러서 새로운 레코드를 삽입하고 F 2 을 눌러서 현재 
레코드를 갱신하며 Del 건을 눌러 현재의 레코드를 삭제한다. 이러한 모든 조작은 즉시 
일 어 난다. 사용자들은 QDataTable 의 confirmEdits 속성 을 True 로 설정 하여 자기들의 
편집을 확인할 기회를 얻을수 있다. confirmEdits 속성이 True 라면 모든 삽입과 갱신， 
삭제에 대해 사용자확인이 요구된다. 더 상쾌한 조종을 위하여 confirmlnsert 와 
confirmUpdate , confirmDelete 속성을 개별적으로 설정할수 있다. 

- QDataTable 사용자대면부교제 

QDataTable 들을 위한 기정의 사용자대면부조작은 다음과 같다. 

• 사용자들은 마우스로 흐름띠를 눌러 레코드들을 선택하고 옮길수 있다. 또한 건 
반의 이동건 실례로 왼쪽화살표, 오른쪽화살표，올리화살표，내리화살표, PageUp , 
PageDown , Home , End 를 사용할수 있다. 

• INSERT 는 레코드를 오른쪽 단추로 선택하고 Insert 를 누르거나 또는 Ins (삽입) 
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건을 누르는것으로 시작된다. 사용자는 Tab 와 Shift+Tab 를 사용하여 마당들사이에서 
이동한다. 사용자가 마지막 마당으로부터 떨어져서 Enter 나 Tab 를 누르면 INSERT 가 
일 어 난다. autoEdit 가 TRUE 이 고 사용자가 다른 레 코드로 항행 하면 삽입 이 일 어 난다. 
INSERT 는 Esc ( Escape ) 를 누르면 취소된다. autoEdit 가 FALSE 라면 다른 레코드에로 
의 항행 은 INSERT 를 취 소한다. confirmlnsert 를 TRUE 로 설 정하면 INSERT 할 때 마 
다 사용자에게 확인할것을 요구한다. 

• UPDATE 는 레코드를 오른쪽 단추로 선택하고 Update 를 누르거나 F 2 를 누르는것 
으로 시작된다. 사용자가 마지막 마당으로부터 떨어져서 Enter 나 Tab 를 누르면 갱신이 
일 어 난다. autoEdit 가 TRUE 이 고 사용자가 다른 레 코드로 항행 하면 갱 신이 일 어 난다. 
UPDATE 는 Esc 를 눌러 서 취 소된 다. autoEdit 가 FALSE 일 때 다른 레 코드에 로 항행 하 
면 UPDATE 를 취 소한다. confirmUpdate 를 TRUE 로 설 정하면 UPDATE 할 때 마다 사용 
자에게 확인할것을 요구한다. 

• DELETE 는 레코드를 오른쪽 단추로 찰칵하고 Delete 를 누르거나 Del (삭제)건을 
누름으로써 이루어 진다. confirmDelete 를 TRUE 로 설정 하면 DELETE 할 때마다 사용자 
에게 확인할것을 요구한다. 

필요하다면 기정동작을 프로그람적으로 변경할수 있다. 

3) 두개 표의 련결 

흔히 자료기 지 는 관련된 표들의 쌍을 가지 고있 다. 례 를 들면 청 구서 표는 청 구서항 
목표가 보관하는 실제 청구서항목이 아니라 청구서의 번호와 날자，손님들을 목록할수 
있다. book 응용프로그람에서는 저자표를 통하여 열람하는데 사용할수 있는 첫째 
QDataTable 과 저 자들이 저 술한 도서 를 보여 주기 위한 두번째 QdataTable 을 가진다. 

Qt Designer 가 이 미 열 려있지 않으면 book 프로젝트를 연다. 이 프로젝 트를 수정 
하여 저자표를 도서표와 련결하는 2개의 QDataTable 을 보여준다. 

① 저 자 QDataTable 을 선택 하고 Break Layout 도구단추를 찰칵한다. 

② 단지 폼의 우의 절반을 차지하도록 DataTable 의 크기를 변경한다. 

③ DataTable 도구단추를 찰칵하고 폼의 아래 절반을 선택 한다. Table Wizard 가 나 
타난다. (이 위자드는 자료기지표의 고속보기에서 설명된다.) 다음과 같이 조작한다. 

• 사용하고있는 련결을 선택하고 도서표를 선택한다. Next 단추를 찰칵한다. 

• 그것들을 보이게 하려고 하지 않으므로 authorid 를 확인하고 id 마당은 화살단추를 
사용하여 Available Fields 목록칸으로 움직이게 된다. 제목마당을 Displayed Fields 의 
꼭대기로 이동하고 notes 마당우의 price 마당을 이동한다. Next 단추를 찰칵한다. 

• Table Properties 페지 에서 Read Only 검사칸을 선택 하고 Next 단추를 찰칵한다. 

• SQL 폐지에서 Filter (WHERE 절)를 비워놓는다. 제목마당을 Sort By 목록칸으로 
이동하고 Next 를 찰칵한다. Finish 를 찰칵한다. 
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• QDataTable 의 이름을 BookDataTable 로 변경한다. 

④ Shift 를 누른 상태 에서 최상우의 QDataTable 을 선택하고 기 타 QDataTable 들 
을 선택 한 다음 Lay Out Vertically (in Splitter ) 도구띠 단추를 찰칵한다. 

⑤ 픔을 선택하고 Lay Out Vertically 도구띠 단추를 찰칵한다. 

Preview | Preview Form 을 선택하여 종을 미리보기한다. 모든 저자는 최상위의 
QDataTable 에 표시되고 모든 도서는 아래의 QDataTable 에 표시된다. 그러나 바닥의 
QDataTable 에서 표시되는 현재 선택된 저자의 도서들만 요구한다. 저자표에서 선택된 
저자에 따라서 도서표에서 레코드들을 려과함으로써 이것을 취급한다. 

- 표편집기의 사용 



그림 1-68. Edit Table 대화칸 

SQL Table 위자드를 사용하여 QDataTable 을 창조하고 설정한다. 다른 Qt 
Designer 창문부품처럼 그 속성을 Properties 창문에서 변경 할수도 있다. 속성에 기초한 
일부 렬과 행은 Edit Table 대화칸을 사용하여 변경할수 있다. 이 대화칸은 
QDataTable 을 오른쪽 단추로 선택하고 Edit 차림표항목을 왼쪽 단추로 눌러서 펼친다. 
Edit Table 대화칸의 오른쪽 절반은 표시하려는 마당들과 그 순서，표식들을 선택하는 
곳이다. 렬을 만드는 절차는 다음과 갈다. 

① New Column 단추를 찰칵한다. 

② Field 복합칸을 펼 치 여 사용가능한 마당을 표시 한다. 

③ 포함하려는 마당을 선택한다. 
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④ 기정값이 적당하지 않으면 선택적으로 Label 을 편집한다. 

§) Pixmap 생 략(…) 단추를 찰칵하고 렬표식자의 왼쪽에 표시 하려는 픽스매프를 선 
택 한다. (생 략단추는 pixmap 또는 iconSet 속성 에 의 해 Properties 목록의 Value 부분을 
선택할 때 나타난다.) 

추가하려는 매개 렬에 대 하여 우의 단계를 반복한다. 모든 마당을 추가하였다면 푸 
른색의 올리와 내리 화살단추를 사용하여 그 순서를 바물수 있다. 임의의 점에서 
Apply 를 눌러서 표의 표시를 확인할수 있다. 끝으로 OK 단추를 찰칵하여 설정한 속성 
을 보관한다. 항상 표편집 기 로 되돌아와서 이 설정 을 변경할수 있 다. 

- 한개 QDataTable 을 다른것에 의하여 려과하기 

도서 표의 레 코드를 려 과하기 위 하여 저 자 QDataTable 의 currentChanged() 신호를 받 
아들이고 BookDataTable 의 려과기를 변경한다. 

0) Edit | Slots 를 선택 한다. Edit Functions 대 화칸에서 New Function 을 선택 하고 
newCurrentAuthor(QSqlRecord*) 라는 처 리 부이 름을 입 력한다. OK 를 찰칵한다. 

② Edit | Connections 을 선택 하여 View and Edit Connections 대화칸을 연다. 
Au 比 lorDataTable 의 currentChangedO 신호를 폼의 newCurrentAu 比 ior() 처리 부에 
련결하는 새로운 련결을 만든다. OK 를 찰칵한다. 

③ Object Explorer 창문의 Members 타브를 선택한다. (필요하다면 
Window | Views | Object Explorer 를 선택 하여 창문을 표시 한다. ) newCurrentAuthor() 처 
리 부를 선택하면 편집 기 창문이 나타난다. 

④ BookForm::newCurrentAuthor() 처 리 부를 변경 하여 파라메 터 이 름을 지 정 하고 필 요한 
작용을 처 리한다. 

void BookForm: : newCurrentAuthor( QSqlRecord * author ) 

BookDataTable->setFilter( "authorid=" + author->value( "id" ).toString() ); 

BookDataTable->refresh(); 

} 

지금 필요한것은 BookDataTable 의 려과기를 바꾸고 려과기의 결과를 보여주도록 
QDataTable 을 재 생 하는것 이 다. 

- Drilldown 용 대 면부의 준비 

이제는 저자들을 열 람하고 편집 할수 있으며 BookDataTable 에서 그들의 책을 볼수 
있다. 다음 절에서는 QDataBrowser 를 탐구한다. 이것은 책을 편집할수 있는 대화칸을 
펼칠수 있게 한다. 현재는 도서편집대화칸을 여는데 사용하는 기본 BookForm 에 단추들 
을 추가한다. 

fl) 좀을 선택 하고 Break Layout 도구띠 단추를 찰칵한다. 바닥에서 단추들에 필요한 


140 



자리를 픔에 만들어주기 위하여 크기를 변경한다. 

② 2개 단추를 폼의 바닥에 추가한다. 이름과 표식자를 다음과 같이 변경한다. 
EditPushButton - &Edit Books 
QuitPushButton ― &Quit 

Shift 건을 누르면서 두개의 단추를 누르고(즉 Shift 를 누르면서 단추들을 찰칵한 
다. ) Lay Out Horizontally 도구띠 단추를 찰칵한다. 픔을 선택 하고 Lay Out 
Vertically 도구띠 단추를 찰칵한다. 

이제는 Quit 단추에 기능을 제공한다. EditlConnec 仕 ons 을 선택한 다음 Quit 단추 
의 clickedO 를 픔의 acceptO 처리부에 련결하다. OKI 찰칵한다. 

3. QDataBrowser 와 QDataView 의 리용 



그림 1-69. Book 응용프로그람의 Edit Books 대화칸 
- QDataBrowser 설정 

이제는 새로운 좀을 창조하여 사용자에게 책 레코드를 편집하게 한다. New 도구띠단 
추를 찰칵하고 New File 대화칸에서 Dialog 형판을 선택하고 OK 를 찰칵한다. 폼이름을 
EditBookForm 으로，제 목을 Edit Books 로 변경 한다. Save 도구띠 단추를 찰칵하고 파일 
을 ed 加 ook . ui 라고 부론다. 이제는 QDataBrowser 를 추가하여 책레코드들을 보여줄수 
있는 폼이 있다. 

① Data Browser 도구띠 단추를 찰칵하고 좀을 선택 한다. Data Browser Wizard 가 
나타난다. 
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② Database Connection and Table 위 자드페 지는 존재 하지 않는 련결을 설정 하고 
QDataBrowser 를 위한 표 또는 보기를 선택하는데 사용된다. 

Database Connection 목록칸에서 사용하려는 련결 례를 들면 ’’(default) "을 선택 
한다. 사용가능한 표와 보기들이 Table 목록칸에 나타난다. 책표를 선택하고 Next 단추 
를 찰칵한다. 

■) Displayed Fields 위 자드페 지는 QDataBrowser 에서 표시 하려는 마당들과 순서 
를 선택하는 수단을 제공한다. 기정으로 주열쇠 (만일 있으면)이외의 모든 마당은 오른쪽 
Displayed Fields 목록칸에 있다. 좌우의 푸른 화살단추들은 Displayed Fields 와 
Available Fields 목록칸사이에서 마당을 움직이는데 사용될수 있다. 올리와 내리의 푸 
른색화살단추는 표시 된 마당들의 현시순서 를 선택하는데 사용된 다. 

우리는 픔에서 외부열쇠마당을 확인하려 고 하지 않으므로 그것을 Available Fields 
목록칸으로 이동한다. 또한 제목마당을 Displayed Fields 목록의 꼭대기로 이동한다. 
Next 단추를 찰칵한다. 

④ Navigation and Editing 위자드페지는 좀에 나타나야 하는 항행 및 단추편집을 
선택하게 한다. 

기정값을 받아들이고 Next 단추를 찰칵한다. 

⑤ SQL 위자드페지는 QDataBrowser 의 Filter 와 Sort 속성들을 설정하는데 사용된 
다. Filter 는 SQL WHERE 절이다. 례를 들면 단지 50 원미만인 책들만 표시하기 위해서 
는 WHERE 없 이 price <50 라고 입 력 한다. 려 과기 를 비 워 놓는다. Available Fields 목록 
칸은 모든 마당을 목록한다. Sort By 목록칸은 QDataBrowser 가 분류하는 마당들과 분 
류방향 (ASCending 혹은 DESCending) 을 표시한다. 좌우의 푸른 화살표들은 2 개의 
목록칸사이 에 서 마당들을 움직 이 는데 사용된 다. 푸른색 의 올리 와 내 리 화살표들은 Sort 
By 목록칸안에서 마당을 상하로 이동한다. ASC 또는 DESC 설정 은 분류순서 단추로 변경 
된 다. 

Sort By 목록칸으로 제목마당을 옮기 고 Next 를 찰칵한다. 

⑥ Layout 위 자드페지는 폼의 처음배 치 를 지정 하는데 사용된다. 

Number of Columns 를 1 로 변경하고 Next 단추를 찰칵하고 Finish 를 찰칵한다. 

海) QDataBrowser 는 폼우에 나타난다. 폼의 크기를 변경하여 더 작게 한다. 
QDataBrowser 를 선택 하고 Break Layout 도구띠 단추를 찰칵한다. 단추들을 누르고 
Break Layout 도구띠 단추를 찰칵한다. 본문 &Close 를 가지 는 PushButtonClose 라고 
부르는 다른 단추를 추가하고 그것을 Delete 단추의 오른쪽에 배 치 한다. 

'⑧ Shift 를 누르면서 Insert 와 Update, Delete, Close 단추를 찰칵한 다음 Lay 
Out Horizontally 도구띠 단추를 찰칵한다. QDataBrowser 를 선택 하고 도구띠 단추에 서 
Lay Out in a Grid 를 선택 한다. 끝으로 좀을 선택 하고 Lay Out Vertically 도구띠 단 
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추를 찰칵한다. 이제는 QDataBrowser 를 선택하고 이름을 BookDataBrowser 로 변경 
한다. 

⑨ Qt Designer 는 필요한 코드(적당한 유표，분류와 려과기코드)를 생성하여 열람 
프로그람을 사용할수 있게 한다. 

폼에 대한 더 상쾌한 조종을 위하여서는 자기의 자료기지유표를 창조한다. 그리하 
여 Properties 창문에서 BookDataBrowser 의 frameworkCode 속성을 FALSE 로 설정 
하고 유표를 위 한 여 분의 코드를 Qt Designer 가 생성 하는것 을 방지 한다. 

- QDataBrowser 사용자대 면부교제 

QDataBrowser 를 위한 사용자대면부동작은 처리부와 신호들을 련결하여 창조한다. 
제공되는 처 리부들은 다음과 갈다. 

• 편집용의 insert() 와 update(), del() 

• 항행 용의 first() 와 next(), prev(), last() 

• 자료기 지 로부터 유표를 재 생 하기 위한 refresh() 

• 유표의 편집 완충기 로부터 자료를 읽 기 위 한 readFields() 과 유표의 편집 완충기 에 폼 
의 자료를 쓰기 위 한 writeFields() 

• 폼의 값들을 지우기 위 한 clearValues() 

Qt Designer 의 QDataBrowser 위 자드를 사용한다면 항행 및 편집 을 위 한 기 정 단추 
모임을 창조하는 선택이 주어진다. 이 단추들의 동작은 다음의 기능을 제공하며 우에서 
서 술한 처 리부에 의하여 설정 된다. 

• INSERT 는 Ins (Insert) 건을 누르는것 으로 시 작된 다. 사용자는 Tab 와 Shift+Tab 
를 사용하여 마당들사이에서 움직 인다. 사용자가 Update 단추를 누르면 INSERT 가 발생 하 
며 사용자는 방금 삽입한 레코드로 간다. 사용자가 Insert 단추를 두번째로 누르면 
INSERT 가 발생 하고 새 로운 삽입 이 시 작된다. autoEdit 가 TRUE 이 고 사용자가 다른 레 코 
드로 항행 하면 INSERT 가 발생 한다. INSERT 는 Esc 건을 누르거 나 Del (삭제 ) 건을 누름으로 
써 취소된다. autoEdit 가 FALSE 일 때 다른 레코드로 항행 하면 IN 況 RT 를 취소한다. 
confirmlnsert 를 TRUE 로 설정 하면 사용자에게 각 INSERT 를 확인할것을 요구한다. 

• 사용자가 레 코드를 항행할 때 마다 UPDATE 는 자동적 으로 시 작된 다. 사용자가 
Update 단추를 누르면 갱 신이 일 어난다. autoEdit 가 TRUE 이 고 사용자가 다른 레 코드 
로 항행하면 갱 신이 일 어난다. UPDATE 는 Esc 건을 누르거 나 Del 단추를 누름으로써 취 
소된다. autoEdit 가 FALSE 일 때 다른 레코드에로의 항행은 UPDATE 를 취소한다. 
confirmUpdate 를 TRUE 로 설정 하면 사용자에게 각 UPDATE 를 확인할것을 요구한다. 

• DELETE 는 Del 건을 누르는것으로 이루어진다. confirmDelete 를 TRUE 로 설정 
하면 사용자에게 각 DELETE 를 확인할것을 요구한다. 

- 구멍 내 기 처 리 
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이제는 책레코드를 편집하기 위한 폼이 있다. 사용자가 Edit Books 단추를 찰칵할 
때 품를 기동하여 BookDataTable 에서 선택한 레코드를 항행해야 한다. 또한 외부열쇠 
(실례로 authorid) 를 편집하는 수단을 제공해야 한다. 

① Edit Books 단추의 clicked() 신호를 련결할 새 로운 처 리부를 만들어 야 한다. Book 
픔을 선택 하여 Qt Designer 의 능동폼으로 한다. Edit Functions 대화칸을 호출하고 
editClicked() 라는 이름의 새로운 기능을 창조한다. 이제 Edit | Connections 를 선택 한다. 
Edit Books 단추의 clicked() 신호를 폼의 editClicked() 처리부에 련결한다. OK 를 찰칵하여 
대화칸을 닫는다. 

② Object Explorer 창문에서 Members 를 선택 하고 editClicked 함수를 선택 한다. 그 
것을 다음과 같이 변경한다. 

void BookForm: : editClicked() 

{ 

EditBookForm *dialog = new EditBookForm(this, "Edit Book Form", TRUE); 
QSqlCursor cur( ’’book，，); 
dialog->BookDataBrowser->setSqlCursor( &cur ); 
dialog->BookDataBrowser->setFilter( BookDataTable->filter() ); 
dialog->BookDataBrowser->setSort(QSqlIndex::fromStringList( 

BookDataTable->sort(), &cur ) ); 
dialog->BookDataBrowser->refresh(); 
int i = BookDataTable->currentRow(); 
if ( i == -1 ) i = 0; // Always use the first row 
dialog->BookDataBrowser->seek( i ); 
dialog->exec(); 
delete dialog; 

BookDataTable->refresh(); 

} 

이전과 같이 대화칸을 만든다. 또한 책표우에 유표를 창조하고 대화칸의 
QDataBrowser, BookDataBrowser 를 설정하여 새 유표를 사용한다. 기본픔의 책 
QDataTable 에 적용되는 것들로 QDataBrowser 의 려과기와 분류를 설정한다. 
QDataBrowser 를 재생 하고 사용자가 기본폼에서 보는것과 같寒 레코드를 탐색 한다. 그 
다음 대화칸을 실행하고 사용자가 완료했을 때 그것을 삭제한다. 끝으로 기본좀에서 
BookDataTable 을 갱신하여 대화칸에서 만들어진 변경을 반영한다. 

③ 우리 코드가 editbook.h 에서 선언된 들라스와 QDataBrowser 를 참고하므로 2 개의 
머 리부파일을 추가한다. BookForm 을 선택 하고 Object Explorer 창문의 Members 타브를 
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선택 한다. Includes (In Declaration) 항목을 오른쪽 단추로 선택하고 New 를 찰칵하고 
editbook.h 라고 입력 한다. 이제 둘째 머 리 부파일 <qdatabrowser. h> 를 포함한다. 

BookForm 에 서 저 자와 책 레 코드를 통하여 항행 할 때 Edit Books 단추를 찰칵하여 
Edit Books 대화칸을 연다. 비록 대화칸이 책표에서의 UPDATE 와 DELETE, 항행을 
지 원하지 만 외 부열 쇠 를 편집 할수도 없 고 삽입 할수도 없 다. QDataTable 에 서 와 같은 방 
법 으로 삽입을 취급하고 저 자와의 외부열쇠관계를 조종한다. 

- QDataBrowser 에 삽입 

유일 한 주열 쇠 를 삽입할수 있도록 Edit Books 폼의 primelnsertO 신호를 받기 위한 처 
리부를 창조한다. 

Edit Books 좀를 선택하고 primeInsertBook(QSqlRecord*) 라는 이름으로 새로운 
Slot 를 창조한다. 

Edit|Slots 를 선택하고 New Function 단추를 찰칵하고 Function Properties 
Function 편집칸에 서 새 로운 함수이 름을 입 력 하고 OK 를 찰칵한다. 

② BookDataBrowsei •의 primelnsertO 신호를 primeInsertBook() 처 리 부에 련결한다. 

Connect Signals/Slots 도구띠 단추를 찰칵한 다음 BookDataBrowsei^ 선택 하고 
픔우로 끌고가서 마우스를 놓는다. 그리고 primelnsertO 신호와 primelnsertBook 처리 부 
를 선택하고 OK 를 찰칵한다. 

§) Object Explorer 창문에 서 는 Members 를 선택 하고 primelnsertBook 처 리 부를 선택 
한다. 다음과 같이 변경한다. 

void EditBookForm: : primeInsertBook( QSqlRecord * buffer ) 

{ 

QSqlQuery query; 

query.exec( "UPDATE sequence SET sequence = sequence + 1 ’’ 

"WHERE tablename='book , ; M )； 

query.exec( "SELECT sequence FROM sequence WHERE tablename='book';" ); 

if ( query.next() ) { 

buffer->setValue( "id", query.value( 0 ) ); 

} 

} 

④ 또한 사용자대면부를 좀 아름답게 하려고 한다. Update 단추를 찰칵하고 기정속 
성을 True 로 설정한다. Close 단추의 clicked *} 신호를 EditBookForm 의 accept () 처리부에 
련결한다. 

- QDataBrowser 에서 외부열쇠 조종 

Qt 의 SQL 모듈에서 외부열쇠를 취급하는 2 가지 수법을 제공한다. 가장 강력하고 유 
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연한 수법 은 창문부품들의 파생 콜라스를 만드는것 과 속성 략도를 사용하여 창문부품들을 
자료기지와 련결하는것 이 다. 이 수법은 Qt SQL 모둘문서 (특히 StatusPicker 실례)에서 서 
술된다. Qt Designer 에서 전적으로 취할수 있는 더 단순한 수법을 여기서 설명한다. 

새로운 마당을 EditBookForm 에 추가하여 저자들을 제목과 가격과 함께 편집할수 
있게 한다. 시각적으로 설계 하였다면 코드를 써서 그것 이 모두 작업 하게 한다. 

C * 우선 새 창문부품을 추가한다. BookDataBrowser 를 선택하고 Break Layout 
도구띠단추를 찰칵한다. 폼의 크기 를 더 크게 하고 매 개 단추모임 을 끌어 서 제 목와 가격 
QLineEdit 들아래 에 빈자리를 만든다. Text Label 도구띠 단추를 찰칵하고 폼에서 
Price 표식자아래를 선택한다. Text Label 을 선택하고 본문을 Au 仕 ior 로 변경한다. 
ComboBox 도구띠 단추를 찰칵하고 폼우에서 가격 QLineEdit 의 아래 를 선택 한다. 
Property Window 에서 ComboBox 의 이름을 ComboBoxAuthor^. 바꾸고 
sizePolicy hSizeType 를 Expanding 으로 바꾼다. 

② 대화칸을 배치한다. Shift 를 누른 상태에서 Author 표식자과 ComboBox 를 선택 
한 다음 Lay Out Horizontally 도구 띠 단추를 찰칵한다. BookDataBrowser 를 선택 하 
고 Lay Out in a Grid 도구 띠 단추를 찰칵한다. 

코드를 추가하여 ComboBox 에 저자이름들을 보관하고 현재 책의 저자에게로 스크 
롤할수 있게 한다. 또한 책레코드를 삽입하거나 갱신할 때 저자 id 를 책표의 au1;horid 마 
당에 넣는다는것을 담보해야 한다. 그것을 처리부에 넣고 신호를 처리부에 련결하여 코 
드가 정확히 실행되도록 담보한다. 

通) beforeUpdateBook(Q SqlRecord *buffer) 와 primeUpdateBook(QSqlRecord *buffer) 라는 
이 름으로 2 개의 새 로운 처 리부를 만든다. (Edit 1 Slots 를 선택 하고 Edit Functions 대 화 
칸에서 New Function 을 선택하고 첫번째 새로운 처 리부를 입력한다. New Function 
을 다시 선택하고 두번째 처 리부를 입력하고 OK 를 찰칵한다.) 

透) 사용자가 대 화칸을 통하여 항행할 때 새 로운 레 코드로 옮길 때 마다 
primeUpdateO 신호가 발송된다. 여기에 련결하여 ComboBox 의 현시를 갱신할수 있다. 
자료기지에서 하나의 레코드가 갱신되거나 삽입되기전에 beforeUpdate() 혹은 
beforelnsertO 신호가 발송된다. beforeUpdateBook() 처리부를 두개의 신호에 련결하여 책의 
authorid 마당이 정확히 형성되는것을 담보할수 있다. 

BookDataBrowser 를 선택하고 폼으로 마우스를 끌고가서 놓는다. 그러면 Edit 
Connections 대화칸이 나타난다. beforeUpdate() 신호를 beforeUpdateBook() 처 리부에 련결한 
다. beforelnsertO 신호를 beforeUpdateBook() 처 리 부에 련결 한다. 끝으로 primeUpdate() 신호를 
primeUpdateBook() 처리 부에 련결 한다. 

③ 기 본 코드를 작성 한다. 코드는 qt/tools/designer/examples/book/book7/edi 仕 »ook.ui 에 서 
발취하였 다. 다음과 같이 조작한다. 
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init() 함수로 시작한다. 이 함수는 대화칸이 구성된 다음에 호출되고 그것을 사용하 
여 저자이름을 ComboBox 에 삽입한다. 
void EditBookForm: : init() 

{ 

QSqlQuery query( "SELECT surname FROM author ORDER BY surname;" ); 
while ( query.next() ) 

ComboBoxAuthor->insertItem( query.value( 0 ).toString()); 

} 

여기에서는 질문을 실행하여 저자이름목록을 얻고 ComboBox 에 각각 삽입한다. 
다음에 레코드가 자료기지에서 갱신(삽입)되기전에 실행되는 코드를 쓴다. 
void EditBookForm: : beforeUpdateBook( QSqlRecord * buffer ) 

{ 

QSqlQuery query( "SELECT id FROM author WHERE surname =’" + 
ComboBoxAuthor->currentText() + ); 

if ( query.next() ) 

buffer->setValue( "authorid", query.value( 0 ) ); 

} 

ComboBox 에서 현재저자의 id 를 찾고 그것을 갱신(또는 삽입)완충기의 authorid 
마당에 배치한다. 

사용자가 레코드를 항행할 때 ComboBox 가 현재의 저자를 반영한다는것을 담보한다. 

void EditBookForm: : primeUpdateBook( QSqlRecord * buffer ) 

{ 

// Who is this book's author? 


QSqlQuery query ( "SELECT surname FROM author WHERE id=' M + 
buffer -> value ( " authorid " ). toString () + )； 

QString author = ，…; 
if ( query . next () ) 

author = query . value ( 0 ). toString (); 

// Set the ComboBox to the right author 
for ( int i = 0; i < ComboBoxAuthor -> count (); i ++ ) { 
if ( ComboBoxAuthor -> text ( i ) == author ) { 
ComboBoxAuthor -> setCurrentItem ( i ) ; 
break ; 

} 
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} 

} 

우선 책의 저 자를 찾고 다음으로 그 저 자를 찾을 때까지 ComboBox 의 항목들을 순 
환하여 대조되는 저 자로 ComboBox 의 현재항목을 설정 한다. 

저자이름이 바뀌거나 삭제되였으면 질문은 실패하고 저자 id 는 완충기에 삽입되지 
않는다. ComboBox 를 구성 할 때 저 자 id 들을 기 록하거 나 QMap 에 보관하고 필 요에 따라 
서 찾는 방법 을 선택한다. 이 수법 은 init() 와 beforeUpdateBook() , primeInsertBook() 함수에 
대한 변경과 새로운 함수 mapAuthor() 의 추가를 요구한다. 

qt/tools/designer/examples/book/book8/edi 仕 >ook.ui 로부터 련 관된 코드를 아래 에 보여 준다. 

|) 우선 저자이름을 저자 id 로 넘기기 위하여 클라스변수를 창조한다. Object 
Explorer 의 Members 타브를 선택하고 Class, Variables 항목을 오른쪽 단추로 선택 하고 
New 를 찰칵한다. QMap<QString, int> authorMap 라고 입 력 한다. 

② 그다음 저 자 id 들을 initO 함수에 기록한다. 

void EditBookForm: : init() 

{ 

QSqlQuery query (’’SELECT surname, id FROM author ORDER BY surname;); 

while ( query.next() ) { 

ComboBoxAuthor->insertItem( query.value( 0 ).toString() ); 

int id = query.value( 1 ).toInt(); 

mapAuthor( query.value( 0 ).toString(), id, TRUE ); 

} 

} 

매 저 자의 이 름을 ComboBox 에 삽입 한 다음에 저 자이 름과 id 로서 QMap 를 구성 한다. 

③ 저자 id 를 자료기지에서 조사하지 않고 QMap 에서 조사한다. 

void EditBookFonn: : beforeUpdateBook( QSqlRecord * buffer ) 

{ 

int id; 

mapAu 仕 ior( ComboBoxAuthor->currentText(), id, FALSE ); 

buffer->setYalue( "authorid", id ); 

} 

④ 저자 id 들을 보관하고 돌려주는 하나의 함수를 사용하여 정적자료구조를 사용할 
수 있게 한다. 

void EditBookForm::mapAuthor(const QString & name, int & id, bool populate) 

{ 
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if ( populate ) 

authorMap[ name ] = id; 
else 

id = authorMap[ name ]; 

} 

populate 기발이 TRUE 이면 저자의 이름과 id 를 QMap 에 보관하고 그렇지 않으 
면 주어 진 저 자이 름을 찾고 id 를 적 당히 설정한다. 

⑥ 갱신하기 전에 au 比 ior 복합칸이 정확한 저자를 보여준다는것을 담보해야 한다. 
void EditBookForm: : primeUpdateBook( QSqlRecord * buffer ) 

{ 

int id = buffer->value( "authorid” ).toInt(); 

for ( int i = 0; i < ComboBoxAuthor->count(); i++ ) { 

QString author = ComboBoxAuthor->text( i ); 
if ( authorMap.contains( author ) && authorMap[author] = id ) { 
ComboBoxAuthor->setCurrentItem( i ) ; 
break; 

} 

} 

} 

응용프로그람의 각이한 부분들에서 같은 외부열쇠검색이 요구될 때 특별히 유용한 
다른 수법은 유표의 파생콜라스를 작성하고 이것을 검색에 사용하는것이다. 

제8절. Qt Designer 의 전용화와 통합 

1. Qt Designer 의 전용화 

Qt Designer 는 두가지 방법으로 전용화할수 있으며 사용자정의창문부품을 추가하 
여 Qt Designer 의 작업 환경 을 변경할수 있 다. 사용자정 의 창문부품은 6 절 에서 설명 하였 
다. 여기서는 Qt Designer 자체의 전용화에 초점을 둔다. 

Qt Designer 의 도구띠는 모두 류동가능하므로 도구띠핸들에 의하여 끌고다니고 마 
음대로 배렬할수 있다. 또한 Files 와 Object Hierarchy, Property Editor, Output 
Windows 은 류동가능하므로 자기가 요구하는 위치까지 끌고갈수 있다. 또한 Qt 
Designer 의 류동령역밖으로 끌고감으로써 류동창문으로 만들수 있다. 

Edit | Preferences 를 선택 하여 Preferences 대화칸을 열고 일반적 인 선택을 설정 할 
수 있다. Restore Last Workspace on Startup 검사칸을 선택 하면 Qt Designer 는 도 
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구띠와 류동가능창문의 크기와 위치를 기억한다. 색이나 픽스매프를 선택하여 Qt 
Designer 의 기본창문배경을 변경할수 있다. 또한 배치의 사용이 여분의 살창을 만드므 
로 살창의 표시 를 해 제할수 있 다. 

Preferences 대화칸은 설치한 플라그인에 따라서 추가적인 타브를 가질수 있다. 
C++ Editor 타브가 기정으로 설치되므로 이것을 설명한다. 

C++ Editor 타브는 Qt Designer 코드편집기에서 강조표시되는 구문용서체를 선택하 
는데 사용된다. 모든 원소에 해당한 기준서체는 목록의 마지막 항목인 Standard 원소로 
설정된다. 처음부터 끝까지 하나의 서체를 사용하려고 Standard 서체를 설정하면 다른 
모든 원소들은 그 설정을 계승한다. 

2. Qt Designer 의 코드편집기 

코드편집기는 Editor 플라그인이 설치되면 사용할수 있다. C++Editor 플라그인은 기 
정으로 설치된다. 

코드편집기는 다음의 건결합을 제공한다. 

Left Arrow — 유표를 한 문자 왼쪽으로 이동한다. 

Right Arrow — 유표를 한 문자 오른쪽으로 이동한다. 

:tJp Arrow — 유표를 한행 우로 이동한다. 

Down Arrow — 유표를 한행 아래 로 이동한다. 

Page Up 一 유표를 한 폐지 우로 이동한다. 

Page Down ― 유표를 한 폐지 아래 로 이동한다. 

Backspace — 유표의 왼쪽문자를 삭제한다. 

Home — 유표를 행의 선두로 이동한다. 

End — 유표를 행의 끝으로 이동한다. 

Delete ― 유표의 오른쪽문자를 삭제 한다. 

Ctrl+A — 유표를 행의 선두로 이동한다. 

Ctrl+B ― 유표를 한 문자 왼쪽으로 이동한다. 

Ctrl+C — 선택된 본문을 오려둠판에 복사한다. (Windows 에서는 Ctrl+Insert) 

Ctrl+D — 유표의 오른쪽문자를 삭제 한다. 

Ctrl+E — 유표를 행의 끝으로 이동한다. 

Ctrl+F — Find Text 대화칸을 연다. 

Ctrl+G 一 Goto Line 대화칸을 연다. 

Ctrl+H — 유표의 왼쪽문자를 삭제한다. 

Ctrl+I — 행이나 유표를 포함하는 선택본문을 들여쓴다. 

Alt+I — 증분람색 을 시 작한다. (아래를 보시 오. ) 

Ctrl+K - 유표위 치부터 행끝까지 삭제 한다. 
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Ctrl+N — 유표를 한행 아래로 이동한다. 

Ctrl+P ― 유표를 한행 우로 이동한다. 

Ctrl+R — Replace Text 대화칸을 연다. 

Ctrl+V ― 오려둠판의 본문을 행편집에 붙이기한다. (Windows 에서는 

Shift + Insert ) 

Ctrl+X — 표식 된 본문을 자르기 하여 오려 둠판에 복사한다. (또한 Windows 에서 는 
Shift + Delete ) 

Ctrl+Y — 마지막 조작을 재실행 한다. 

Ctrl+Z — 마지막 조작을 취소한다. 

Ctrl+Left Arrow — 유표를 한 단어 왼쪽으로 이동한다. 

Ctrl+Right Arrow — 유표를 한 단어 오른쪽으로 이동한다. 

Ctrl+Up Arrow — 유표를 한 단어 우로 이동한다. 

Ctrl+Down Arrow — 유표를 한 단어 아래 로 이동한다. 

Ctrl+Home Arrow — 유표를 본문의 선두로 이동한다. 

Ctrl+End Arrow — 유표를 본문의 끝으로 이동한다. 

Tab - 보완. 

본문을 선택(표식)하기 위하여 Shift 건을 누르면서 이동건중 하나를 누른다. 례를 
들면 Shift+Right Arrow 는 오른쪽 문자를 선택하고 Shift + Ctrl+Right Arrow 는 오른 
쪽 단어를 선택한다. 

Alt+I 를 눌러서 증분탐색을 시작한다. 입력한 문자들은 Search 도구띠의 
Incremental Search 행편집에 나타나고 유표는 편집기에서 처음으로 일치하는 본문에로 
이동된다. 입 력하면 탐색을 계속한다. Return 을 눌러서 다음의 일치 하는 본문으로 이동 
하고 Esc 를 눌러서 그때 도달한 위치에서 탐색을 취소한다. 

1 개이상의 문자를 입력한 다음 Tab 를 눌러서 보완한다. 보완작업을 다음과 같다. 
본문입력을 시작하고 Tab 를 누른다. 편집기가 갈은 문자들로 시작하는 본문의 다른 항 
목을 발견한다면 본문을 보완하게 한다. 가능한 본문을 한개이상 발견하면 선택목록을 
펼친다. 화살건을 사용하여 본문을 하나 선택하고 Return 을 누르거나 Esc 를 눌러서 입 
력을 계속한다. Preferences 대화칸에서 보완을 차단할수 있다. 

-> 혹은 .을 입력할 때 편집기는 지령보완목록을 펼친다. 이때 화살건을 사용하여 
요구하는 항목으로 이동하고 Return 를 누르거 나 Esc 를 눌러서 목록을 무시 한다. 

3. 형판의 작성과 리용 

Qt Designer 는 두가지 수법 으로 형판폼을 창조한다. 가장 간단한 수법은 형판등록 
부에 . ui 파일을 보관하는것 이 다. 둘째 수법은 형판을 사용하는 폼들에서 기초콜라스로 사 
용하려 는 용기창문부품클라스의 창조한다. 여 기서 는 두가지 기술을 설명 한다. 
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1) 간단한 형 판 

이 형판들은 공통창문부품들을 가지는 종들의 전체 모임을 창조하려고 할 때 가장 
효과적이다. 실례로 프로젝트가 많은 폼들을 요구하고 그 모두가 회사이름과 략호 
( logo ) 가 있는 상표를 요구한다. 

우선 간단한 형판을 창조한다. 

® File | New 를 선택하여 New File 대화칸을 연다. Dialog template 를 선택하고 
OK 를 찰칵한다. 

建) Text Label 도구띠단추를 찰칵하고 폼의 왼쪽웃구석 근방을 선택 한다. font 
Point Size 속성을 16으로， text 속성을 자기 또는 자기 회사의 이름으로 변경한다. Line 
도구띠단추를 찰칵하고 표식 자아래 의 폼부분을 선택한다. 그리 고 튀 여나오기차림 표에 서 
Horizontal 을 선택한다. 

③ 표식 자과 행 을 선택 한다. ( Ctrl 을 누르면서 폼을 선택 하고 선택 창을 행과 표식 자 
가 닿거 나 포함되도록 확대 한다.) Ctrl + L 을 눌러서 수직으로 배 치 한다. 

④ Save 도구띠 단추를 찰칵한다. Save As 대 화칸에 서 Qt Designer 의 형 판등록부로 
이 행 한다. 실례 로 qt/tools/designer/templates 를 들수 있다. 이름을 Simple _ Dialog . ui 라고 
입 력 하고 Save 를 선택한다. 

⑤ Forms 목록에서 폼을 오른쪽 단추로 찰칵하고 Remove form from project 를 선 
택 한다. 

간단한 형판을 가지게 되고 그것을 사용할 준비가 되였다. File | New 를 선택하고 
New File 대 화칸을 선택 한다. 나타나는 형 판들중 하나는 Simple Dialog 이 다. 단순한 대 
화칸을 선택하고 OK 를 찰칵한다. 새로운 폼이 형판와 갈은 창문부품과 배치와 함께 나 
타난다. 다른 창문부품과 기능을 추가한다. 종을 보관하려고 시도할 때 새로운 폼의 이 
틈을 묻는다. 

2) 기초들라스형판 

이 형판들은 기초클라스에 기초한 모든 폼들이 계승할수 있는 기정기능을 제공하려 
고 할 때 쓸모있다. 실례에서는 형판의 기초로서 크기를 보관하는 SizeAware 라는 클라 
스를 사용한다. 클라스자체를 서술하지 않지만 Qt Designer 형판로서 그것을 사용하게 
하는데 초점을 둔다. 이 콜라스의 원천은 qt/tools/designer/examples/sizeaware 에 있다. 

형 판는 사용자정 의창문부품이 나 현존용기창문부품에 기 초할수 있다. 

형판이 사용자정의창문부품에 기초하게 하려면 우선 그것을 Qt Designer 의 사용자 
정의 창문부품에 추가하여야 한다. Tools [ Custom | Edit Custom Widgets 를 선택 하여 
Edit Custom Widgets 대화칸을 연다 (6 절 소절1 참고). New Widget 를 선택한다. 콜라 
스를 MyCustomWidget 로부터 SizeAware 로 변경 한다. Header file 생 략단추를 찰칵하 
고 파일 qt/tools/designer/examples/sizeaware/sizeaware.h 을 선택 한다. Container Widget 검 사 
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칸을 선택한다. 이 콜라스는 2가지 속성을 제공한다. Properties 타브를 선택한다. New 
Property 를 선택 하고 속성이 름을 company 로 변경 한다. 다시 New Property 를 선택 
하고 속성이름을 settingsFile 로 변경 하고 Close 를 선택 한다. 

현존창문부품 혹은 자체의 사용자정의창문부품에 기초하여 형판을 창조하려면 
File)Create Template 를 선택하여 Create Template 대화칸을 연다. Template Name 을 
SizeAware 로 변경하고 SizeAware 기초들라스를 선택하고 Create 를 찰칵한다. 대화칸은 
형 판을 창조하고 즉시 그자체 를 닫는다. Qt Designer 를 닫고 그것을 재 기동한다. 

새 형판 SizeAware 는 현재 형판목록에서 사용할수 있다. File|New 를 선택하고 
SizeA ware 를 선택하고 OK 를 찰칵한다. 두개의 속성 company 와 settingsFile 은 
Properties 창문에서 사용할수 있다. 이 형판에 기초하는 홈들은 자기의 크기를 기억하 
며 재적재될 때 크기가 조절된다.(실천에서 폼마다 하나의 settingsFile 을 가지는 응용 
프로그람을 권고하지 않으므로 이 형판는 실제로 단일한 기본창문을 가지는 응용프로그 
람에 만 사용할수 있다.) 


4. Qt Designer 와 Visual Studio 의 통합 

Qt Designer 는 Qt 에 제공되는 比 ieqmsdev.dll 파일을 사용하여 Visual Studio 
6.0 에 통합할수 있다. Visual Studio.Net 는 이러한 통합을 지원하지 않는다. 

새 로운 도구띠 가 Visual Studio 에 나타난다. 도구띠 단추들은 다음과 같다. 

New Qt Project — 작은 응용프로그람위 자드 

New Qt Dialog — 빈 Qt Dialog 를 현재 작업중인 프로젝트에 추가하거 나 현존 대 
화칸을 추가한다. 

Qt GUI Designer — Qt Designer 를 실행 한다. 

Open Qt Project — .pro 를 가지 고 qmake 를 실 행한다. 

Write Qt Project — 현재의 VS 프로젝트를 .pro 파일로서 보관한다. 

Use Qt — Qt 서 고들을 현재 작업중인 프로젝트에 추가한다. 

Add MOC — 현재 작업파일에 moc 사전콤파일러를 추가한다. 

작업공간창문에서 .ui 파일을 두번 련속 누르면 Qt Designer 가 호출된다. 

Q_OBJECT 마크로를 포함하는 .cpp 파일을 창조한다면 moc 에 의 해 생성되 는 추가적 인 
파일이 프로젝트에 포함되여야 한다. 실례로 file.cpp 가 있다면 마지막 행이 #include 
"file.moc" 이 여 야 하며 추가파일 이 file.moc 를 호출한다. 그것 을 담보하기 위 하여 Visual 
Studio 가 moc 를 실 행 하여 이 파일 을 생 성 하고 전용의 존관계 를 생 성한다. 프로젝 트작업 
공간에서 Q_OBJECT 마크로를 포함하는 .cpp 파일을 두번 련속 찰칵한다. Add MOC 도구 
띠단추를 찰칵하여 프로젝트작업공간에서 빈 .moc 파일을 생성한다. 새 로 생성한 .moc 파 
일을 오른쪽 단추로 찰칵하고 올리 펼칩차림 표에 서 Settings 를 선택 하여 Project 
Se 竹 ings 대화칸을 펼친다. Custom Build 타브를 찰칵한다. Dependencies 단추를 찰칵 
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하여 User Defined Dependencies 대화칸을 펼친다. $(InputDir)\$(InputPath) 를 입력한 다 
음 Return 을 누른다. OK 를 찰칵하여 Dependencies 대화칸을 닫은 다음 OK 를 찰칵하 
여 Project Settings 대화칸을 닫는다. 

그 add-in 을 삭제하려면 도구띠에서 그것을 삭제하고 add-ins 등록부에서 

theqmsdev.dll 파일을 삭제한다. 

1) qmake 없이 Makefile 작성 

어에 제공된 qmake 도구는 .pro 프로젝트파일에 기초하여 가동환경에 적당한 
Makefile 을 창조할수 있다. 여기서는 Qt 응용프로그람의 건설에 포함된 의존관계를 서 
술하며 한쌍의 간단한 실례 Makefile 을 준다. 그리고 Makefile 에 대하여 리해하고있는 
것으로 가정한다. 

Qt Designer 는 틈파일러가 롬파일하는 上와 .cpp 파일들을 생성하는데 사용되는 .ui 
파일을 생성한다. .ui 파일들은 uic 에 의하여 처 리된다. QObject 로부터 계승되는 클라스들 
실례로 처리부와 신호들을 사용하는 콜라스들은 추가적인 .cpp 파일의 생성을 요구한다. 
이 파일들은 moc 에 의해 생성되 는데 원래 의 .cpp 파일 이 file.cpp 로 불리울 때 
moc_file.cpp 로 이 름지 어 진 다. .cpp 파일 에 Q_OBJECT 마크로가 포함되 여 있 으면 추가적 인 
파일 file.moc 가 생성되여야 하며 .cpp 에서 보통 끝에 포함되여야 한다. 이것은 여분의 
의존관계창조를 요구한다. 

uic 에 의한 .ui 파일처 리는 두번에 걸쳐 수행된다. 
uic myform.ui -o myform.h 
uic myform.ui -i myform.h -o myform.cpp 

첫째 실행은 머리부파일을 창조하고 두번째 실행은 .cpp 파일을 창조한다. 폼의 파생 
콜라스를 만들려 고 한다면 uic 를 사용하여 파생 들라스골격 을 생 성할수 있 다. 
uic formbase.ui -o formbase.h 
uic formbase.ui -i formbase.h -o formbase.cpp 
uic -subdecl Form formbase.h formbase.ui -o form.h 
uic -subimpl Form form.h formbase.ui -o form.cpp 

우선 기 초콜라스를 위한 머 리부파일과 실현파일 을 생 성한다. 그다음 파생콜라스를 
위한 머리부파일과 실현파일골격을 생성한다. 골격생성에서 uic 의 사용은 Makefile 에서 
아무것도 수행하지 않는다. 또한 지령행에서 -subdecl 과 -subimpl 은 좀 다르다. 

QObject 로부터 계승되는 클라스들을 포함하는 실현파일들에 대하여 moc 파일들을 
창조해 야 한다. 

moc myform.h -o moc_myform.cpp 
간단한 Makefile 을 통하여 실제로 의존관계를 고찰하자. 
myapp: moc_myform.o myform.o main.o 
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g++ -lqt -o myapp moc myform.o myform.o main.o 
main.o: main.cpp 

g++ -o main.o main.cpp 
moc myform.o : moc_myform.cpp 

g++ -o moc_myform.o moc myform.cpp 
mocmy form, cpp : myform.h 

moc myform.h -o moc myform.cpp 
myform.o: myform.cpp 

g++ -o myform.o myform.cpp 
myform.cpp: myform.h myform.ui 

uic myform.ui -i myform.h -o myform.cpp 
myform.h: myform.ui 

uic myform.ui -o myform.h 

Makefile 에 서 완전지 령 경 로를 포함해 야 하며 Windows 에 서 파일 이 름은 moc.exe 와 
uic.exe 이 다. 

Unix/Linux 환경 에서 make 지 령 은 더 많은것 을 수행할수 있으므로 다음과 같이 더 
간단한 Makefile 을 사용할수 있어 야 한다. 
myapp: moc_myform.o myform.o main.o 
g++ -lq -o $@ $ A 
%.o: %.cpp 

g++ -o $ A $@ 
moc_%.cpp: %.h 
moc $ A -o $@ 

myform.cpp: myform.h myform.ui 

uic myform.ui -i myform.h -o myform.cpp 
myform.h: myform.ui 

uic myform.ui -o myform.h 

복잡한 Makefile 을 고찰하려면 단지 임의의 Qt 프로젝트에 대하여 또는 Qt 에 제공 
된 실례 에 대 하여 qmake 를 사용하여 생성한다. 

5. 다른 파일형식의 반입 

외부파일형식으로 파일을 반입하기 위하여서는 File | Open 을 누른 다음 File Type 
복합칸을 선택하고 적재하려는 파일형을 고른다. 필요한 파일을 선택하면 Qt Designer 
는 그 파일을 변환하여 적재한다. 

Qt Designer 가 외부파일형식을 읽는데 사용하는 려파기는 진척중에 있다. 여기서 
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서술하는것보다 자기의 Qt Designer 판에서 사용할수 있는 다른 려파기를 가질수 있다. 
유효려파기를 보는 가장 간단한 방법은 파일열기대화칸을 열어보는것인데 모든 려파기가 
File Type 복합칸에 표시된다. 

1) Qt Architect 파일들의 반입 

Qt Architect 는 Jeff Harris 와 Klaus Ebner 가 작성 한 Qt 용의 무료 GUI 건설프로 
그람이다. .dig 확장자는 Qt Architect 대 화칸파일과 련관된다. 

Qt Designer 는 Qt Architect 2.1 이상에 의하여 생성된 파일들을 읽을수 있다. 이 
전판의 Qt Architect 로부터 .dig 파일 이 주어 지 면 Qt Designer 는 그것 을 2.1 판의 파일 형 
식으로 변환하는 방법을 말해준다. (변환절차는 .dig 파일의 판에 따라 변한다.) 

반입 려 파기 는 .dig 파일 반입 작업 을 수행 하며 결과는 Qt Architect 에 서 얻 은것 과 거 의 
같다. 그러 나 대화칸을 사용하는 C ++ 코드는 약간한 수정을 요구한다. 

도구들사이의 차이 로 인하여 Qt Architect 파일들을 Qt Designer 형식으로 변환하는 
데 다음과 같은 몇가지 결함이 있다. 

• 공간과 여백의 배치 - .dig 파일배치가 공간과 여백의 배치에 Qt Architect 기정값 
을 사용하면 Qt Designer 는 이것들을 무시하고 자기의 표준기정값을 사용한다. 필요하 
다면 layoutSpacing 과 layoutMargin 속성을 수동으로 변경 할수 있다. 

• 배 치 확대와 공간 - Qt Architect 는 Qt Designer 보다도 Qt 배 치체계의 더 많은 특 
성 (즉 확대 와 공간) 에 로의 호출을 준다. Qt Designer 는 이 특성 을 사용하는 .dig 파일 들 
에 잘 대 항하려 고 시 도하지 만 때 때 로 크기 조절은 바라는것 이 아니 다. 일 반적 으로 해 결 책 
에는 창문부품들의 sizePolicy 속성의 설정과 수축자의 삽입 혹은 삭제가 포함된다. 

• 관리 및 비관리창문부품들의 혼합 - Qt Architect 는 창문부품이 배치에 의하여 
관리되는 자식창문부품들과 고정위치를 가지는 다른 자식창문부품들을 가지게 한다. 여 
기 에 사용하는 .dig 파일 이 주어 질 때 Qt Designer 는 조용히 고정 위 치 창문부품들을 그 배 
치에 넣는다. 

• 픽스매프 - Qt Designer 는 .dig 파일들에 지정된 픽스매프들을 무시 한다. 이 것들은 
Qt Designer 에 서 수동적 으로 되 살려야 한다. 

2) Glade 파일들의 반입 

Glade 는 Damon Chaplin 이 작성 한 GTK + 와 GNOME 용의 자유 GUI 건설 프로그람 
이 다. 확장자 .glade 는 Glade 파일들을 의미한다. 

Qt Designer 는 판본 0.6.0 까지 Glade 파일들로 시험하였으며 물론 그후판과도 작 
업할수 있 다. 

Glade 가 Qt 를 목표로 하지 않아도 배 치체계와 GTK + 의 창문부품모임은 Qt 와 류사 
하므로 려파기 는 .glade 파일 에 서 대 부분의 정 보를 얻 는다. 

Glade 파일들의 변환과 관련하여 다음과 같이 고려할것이 있다. 
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• 표식 자안의 & - 어는 QLabel 이 짝패 가 아닐 떼 &를 표시 한다. (짝패 는 QLabel 
을 대신하여 초점을 받아들이는 창문부품이 다.) Glade 는 (밑줄이 있는)지름건을 가지는 
GtkLabel 창문부품을 허용하지만 어떤 짝패도 가지지 않는다. 이것은 사용자가 밑줄문 
자가 지름건일것을 기대하므로 오유로 된다. 이 상황에서 Qt 는 지름건을 밑줄로 표시하 
지 않고 &자체를 표시한다. 이때에는 QLabel 창문부품들을 조사하고 buddy 속성을 설 
정 해 야 한다. 

• 대 리 기 호 ( placeholder ) 배 치 - GTK 는 배 치 위 치 를 대 리 기 호가 차지 하도록 한다. 
Qt Designer 는 이 대 리기호들을 본문이 붉은색 QLabel 들로 변환되게 하므로 그것들을 
발견하여 수동적으로 고착시킬수 있다. 

• 어와 등가하지 않은 GTK + 혹은 GNOME 창문부품 - 이는 대부분의 GTK + 창문 
부품들과 등가하지만 Glade 도 역시 GNOME 을 지원하며 그 목표는 완전한 탁상환경을 
제 공하는것 이 다. Qt 의 유효범 위 가 협 소하므로 Qt Designer 는 변환할수 없는 창문부품과 
조우할 때 그것을 문제를 가리키는 표식자로 교체한다. 실례로 GnomePaperSelector 
는 본문이 붉은색의 GnomePaperSelector ? 인 QLabel 로 교체된다. KDE 에 이식 하려고 
한다면 대응하는 KDE 창문부품을 사용하려고 할수 있다. 

다른 GTK+/GNOME 창문부품들은 오직 일정한 상황에서만 유지된다. 실례로 
GnomeDruid 는 다른 창문부품에 매몰될수 있으며 한편 대응하는 QWizard 콜라스는 매 
몰될수 없다. 

• 통보창문과 다른 고준위 대화칸 - Glade 는 GnomeMessageBox 와 
GtkFileSelection , GtkFontSelectionDialog 등의 편집을 유지한다. 이것은 보통 Qt 
에서 QMessageBox 대화칸와 QFileDialog , QFontDialog 등에 의 하여 C ++ 코드로 얻 어 
진 다. 

• 독자적 인 튀 여 나오기 차림 표 - Qt Designer 는 오직 QMainWindow 안에 서 튀 여 나 
오기 차림 표를 유지 한다. 독자적 인 튀 여 나오기차림 표(가령 문맥 차림 표)를 요구한다면 
QPopupMenu 를 사용하여 이것을 수행하는 코드를 간단히 쓸수 있다. 

• 크기 방략파라메 터 - Glade 는 속성 편집 기 의 Place 타브에 서 크기 방략을 제 공한다. 
Qt 기정값들이 보통 충분히 좋을 때 Qt Designer 는 padding 과 expand , shrink , fill 
정보를 사용하려고 하지 않는다. 일부 경우에 sizePolicy 속성을 수동적으로 설정하여 
요구하는 효과를 얻을수 있다. 

• GNOME 표준그림기호 - GNOME 는 아주 큰 표준그림기호모임을 제공한다. Qt 
Designer 는 이 것 들에 대 한 참고를 무시한다. KDE 에 이 식 한다면 수동적 으로 표준 KDE 
그림 기 호들을 설정해 야 한다. 

• Packer 배치 - GTK + 는 다른 종류의 배치에 쓰이는 GtkPacker 라는 들라스를 제공 
한다. 아는 QPackerLayout 를 제공하지 않는다. Qt Designer 는 packer 배 치를 수직배 
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치처럼 취급하며 그것이 정확한 효과를 생성하도록 배치들의 결합으로 변경해야 한다. 

•변환후 부정확하다고 인정된 본문 - hAlign 속성은 때때로 잘못 설정된다. 이 경 
우에 그것을 수동으로 변경해야 한다. Glade 의 변화로 발생된다. 

제 9 절. 지름건 

Ctrl+A - 작업 중인 폼안의 GUI 원소들을 모두 선택한다. 

Ctrl+B - 선택된 배 치를 파피 하여 GUI 원소를 추가，삭제할수 있게 한다. 

Ctrl+C - 작업중인 종으로부터 오려둠판에 선택한 GUI 원소들을 복사한다. 

Alt+E - Edit 차림 표를 펼친다. 

Alt+F - File 차림표를 펼친다. 

Ctrl+G - 선택된 용기에 살창배치를 적용하거나 선택된 GUI 원소들을 포함하는 새 
용기를 창조하고 살창배 치를 이 용기 에 적용한다. 

Ctrl+H - 선택 된 용기 에 수평칸배 치 를 적 용하거 나 선택 된 GUI 원소들을 포함하는 
새 용기 를 창조하고 수평칸배 치 를 이 용기 에 적 용한다. 

Alt+H - Help 차림 표를 펼친다. 

Ctrl+J - 선택된 GUI 원소(또는 원소들)의 크기를 조절하여 그자체를 적당히 표시하 
는데 필요한 최소크기를 가지게 한다. 

Ctrl+L - 선택된 용기에 수직칸배치를 적용하거나 선택된 GUI 원소들을 포함하는 
새 용기 를 창조하고 수직칸배 치 를 이 용기 에 적 용한다. 

Alt+L - Layout 차림표를 펼친다. 

Ctrl+M - Qt Assistant 에서 직결방조문서를 연다. 

Ctrl+N - New File 대화칸을 연다. 

Ctrl+O - Open File 대 화칸을 연다. 

Alt+P - Preview 차림표를 펼친다. 

Ctrl+R - 작업중에 있는 폼에서 지름건들이 중복되는가 검사한다. 

Ctrl+S - 작업중에 있는 폼을 보관한다. 

Ctrl+T - 가동환경의 기정 GUI 형식으로 작업중에 있는 폼을 미리보기한다. 

Alt+T - Tools 차림표를 펼친다. 

Ctrl + V - 오려둠판의 GUI 원소를 작업중에 있는 폼에서 원래의 폼에 있던 위치로부 
터 약간 변위하여 붙이기한다. 오려둠판에 GUI 원소가 없다면 아무일도 하지 않는다. 
Alt+W - Window 차림표를 펼친다. 

Ctrl+X - 선택된 GUI 원소를 작업중에 있는 폼에서 자르기하여 오려둠판에 넣는다. 
Ctrl+Y - 마지막 취소동작을 재시행한다. 
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Ctrl+Z - 마지 막 동작을 취소한다. 

Del - 선택된 GUI 원소들을 작업중에 있는 좀에서 삭제한다. 

F 1 - Qt Assistant 에서 Qt Designer 지도서의 소개폐지를 연다. 

Shift + Fl - What’s This 방식을 투입 한다. 이것은 Qt Designer 에서 GUI 원소를 선 
택 하여 이 원소에 대 한 작은 설명창문을 얻게 한다. 

F 2 - GUI 원소들을 선택하게 하는 지시자도구가 동작하게 한다. 

F 3 - 픔안의 신호-처리부련결을 편집하는 련결도구가 동작하게 한다. 

F 4 - 작업폼우의 GUI 원소들의 타브순서를 변경하는 타브순서도구가 동작하게 한다. 
Ctrl + F 4 - 작업중인 창문을 닫는다. 

Ctrl + F 6 - 다음번에 창조한 창문을 작업창문으로 한다. 

Ctrl + Shift - F 6 - 다음번에 창조한 창문을 작업창문으로 한다. 

제10절. 차림표선택 

Qt Designer 는 응용프로그람을 창조하는데 필요한 작용을 호출하는 차림표선택을 
제공한다. 대부분의 차림표선택은 추가적인 선택과 기능을 제공하는 대화칸창문을 펼치 
게 한다. 가장 일 반적 으로 사용되 는 차림 표선택 들은 또한 대 응하는 도구띠단추들을 가지 
고있다. 이 절에서는 각 차림표선택과 그 사용법을 설명한다. 

1. File 차림표 



그림 1-70. File 차림표 

File 차림표는 Alt + F 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 
FilelNew 을 선택하여(또는 Ctrl + N 을 눌러서) 새 프로젝트, 폼 혹은 파일을 창조 
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한다. 이 선택은 New File 대화칸을 호출한다. 

File | Open 을 선택하여 (또는 Ctrl+ ◦을 눌러서) 현존 프로젝트，폼 혹은 파일을 
연다. 파일이름을 선택할수 있는 File Open 대화칸이 열린다. 

File | Close 를 선택하여 현재 열린 프로젝트를 닫는다. 프로젝트에 보관하지 못한 
변경이 있으면 Save Form 대화칸이 표시된다. 

File | Save 를 선택하여 (또는 Ctrl+S 을 눌러서) 프로젝트를 그 폼과 파일들과 함께 
보관한다. 폼이나 파일들을 가지는 프로젝트에 대하여 Save 를 눌러서 프로젝트를 완료 
하기전에 보관한다. 새 픔들에 대하여 Save 를 선택하면 Save Form As Dialog 가 나타 
난다. 이전에 보관하였던 폼들에 대해서는 Save 를 선택한다. 새 파일들이나 변경된 파 
일들에 대 하여서는 Save 를 찰칵한다. 

File | Save As 를 선택하여 현재품이나 파일을 보관하고 이름을 짓는다. 이 선택은 
Save Form As Dialog 를 펼친다. 

File | Save All 을 선택하여 매개의 열린 프로젝트에 매개의 열린파일과 폼을 보관한다. 

File | Create Template 를 선택하여 폼형판을 창조한다. 이 선택은 Create 
Template Dialog 대 화칸을 펼친다. 

File | Recently Opened Files 를 선택하여 제일 최근에 열었던 파일들을 표시한다. 
그 파일들중 하나를 선택하여 연다. 파일들보다 프로젝트를 열것을 권고한다. 프로젝트 
의 Project Overview Window 에서 파일 이 름을 선택 하여 파일을 열수 있다. 

File | Recently Opened Projects 를 선택 하여 제 일 최 근에 연 프로젝트들을 표시 한 
다. 표시된 프로젝트들중 하나를 선택하여 연다. 

File | Exit 를 선택하여 Qt Designer 를 완료한다. 어떤 열린 파일들에 보관하지 못 
한 변경이 있으면 Qt Designer 가 완료하기전에 Save Form Dialog 통보칸이 그 매개에 
대하여 나타난다. 이전에 보관하지 않았으나 변경된 좀에 대하여 혹은 보관했었는데 변 
경된 좀에 대 하여 Save Form Dialog 이 호출된다. Yes 를 눌러서 Save Form As 대화 
칸을 펼친다. 

2. Edit 차림표 
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Edit 차림표는 Alt+E 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 


Edit|Undo 를 선택하여 (또는 Ctrl+Z 를 눌러서) 동작을 취소한다. 수행된 마지막 
동작의 이름이 Undo 뒤에 나타난다. 

Edit | Redo 를 선택하여 (또는 Ctrl+Y 를 눌러서) 동작을 재시행한다. 수행된 마지 
막 동작의 이름이 Redo 뒤 에 나타난다. 

EditlCut 를 선택하여 (또는 Ctrl+X 를 눌러서) 현재 몸이나 파일로부터 선택항목을 
삭제 하고 그것을 오려둠판에 복사한다. 

EditlCopy 를 선택하여 (또는 Ctrl+C 를 눌러서) 현재 픔이나 파일로부터 선택항목 
을 오려둠판에 복사한다. 

EditlPaste 를 선택하여 (또는 Ctrl+V 를 눌러서) 오려둠판의 항목(있다면)을 현재 
종이나 파일에 붙이기한다. 

Edit | Delete 를 선택하여 (또는 Del 을 눌러서) 현재 폼이나 과일로부터 선택항목을 
삭제 한다. 

Edit ᅵ Select All 을 선택 하여 (또는 Ctrl+A 를 눌러서) 현재 폼의 모든 창문부품 혹 
은 현재 파일안의 모든 본문을 강조표시한다. 

Edit | Check Accelerators 를 선택하여 (또는 Alt+R 를 눌러서) 모든 지름건들이 
오직 한번만 쓰인다는것을 확인한다. 지름건이 한번이상 사용되면 ’The accelerator 
’ x ’ is used ’ y ’ 仕^^터’문의 통보칸이 나타난다. Select 를 선택하여 같은 지름건을 가 
지는 창문부품들을 강조표시하거나 Cancel 을 찰칵하여 어떤 동작이 없이 통보칸을 완료 
한다. 


161 







Edit | Slots 를 선택하여 처리부와 함수들을 편집하고 창조한다. 이 선택은 Edit 
Functions 대화칸을 펼친다. 

Edit | Connections 을 선택 하여 View and Edit Connec 社 ons 대화칸을 펼친다. 
Edit | Form Settings 를 선택하여 Form Settings 대화칸을 펼친다. 

Edit | Preferences 를 선택 하여 Preferences 대화칸을 펼친다. 

3. Project 차림표 



그림 1-72. Project 차림표 

Project 차림표는 Alt + ◦에 의 해 호출되며 다음과 같은 차림 표선택을 제공한다. 
Projectl Active Project 를 선택하여 하나이상의 프로젝트가 열려 있다면 프로젝트 
들을 절환할수 있 다. 또한 File 도구띠 단추안의 Active Project 내 러 펼 침 복합칸을 사용하 
여 프로젝트들사이를 절환할수 있다. 

Projectl Add File 을 선택하여 Add 대화칸을 펼친다 

Project | Project Settings 를 선택 하여 Project Set 仕 ngs 대화칸을 펼친다. 

Project | Image Collec 仕 on 을 선택 하여 Manage Image Collection 대화칸을 펼친다. 
Project | Database Connec 仕 ons 를 선택 하여 Edit Database Connec 社 ons 대 화칸을 
펼친다. 


4. Search 차림표 



그림 1-73. Search 차림표 

Search 차림표는 Alt + S 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 
SearchlFind 를 선택하여 (또는 Ctrl + F 를 눌러서) Find Text 대화칸을 펼친다. 
Search|Find Incremental 을 선택 하여 (또는 Alt + I 를 눌러서) Find 도구띠단추옆 
에 배치된 본문칸에 유표를 놓는다. 본문칸에 문자들을 입력하면 그때 Qt Designer 는 
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파일에서 발견하는 첫 본문을 강조표시한다. Enter 건을 눌러서 본문의 다음 출현으로 
이행한다. 일단 찾으러는 단어를 발견하면 Esc 건을 눌러서 편집기의 유표를 거기에 배 
치 한다. 

Search ᅵ Replace 를 선택하여 (또는 Ctrl + R 를 눌러서) Replace Text 대화칸을 펼 
치고 특정한 단어나 문자들로 교체 한다. 

Search!Goto line 을 선택하여 (또는 Alt + G 를 눌러서) Goto Line 대화칸을 펼치고 
파일안의 지정행으로 이행한다. 


5. Tools 차림표 



그림 1-74. Tools 차림표 

Tools 차림표는 Alt + T 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 

Tools ᅵ Pointer 을 선택 하여 (또는 F 2 를 눌러서) 선택된 창문부품도구띠 단추의 선택 
을 해제한다. 또한 창문부품도구띠단추를 두번 련속 눌렀다면 폼에 새 창문부품삽입을 
중지하는데 지적자를 사용한다. Esc 건을 눌러서 임의의 시각에 지적자로 돌아온다. 

Tools | Connect Signals and Slots 을 선택 하여 (또는 F 3 을 눌러서) 신호와 처 리부 
를 련결한다. 창문부품을 선택하고 련결을 련결하려는 창문부품(또는 폼)까지 끌기한다. 
마우스단추를 놓으면 View and Edit Connections 대화칸이 나타난다. 

Tools | Tab Order 를 선택하여 (또는 F 4 를 눌러서) 건반초점을 받아들일수 있는 폼 
의 모든 창문부품들에 대 하여 타브순서 를 설정 한다. 이 도구띠단추를 찰칵하고 창문부품 
들의 결에 나타나는 수값이 있는 푸른색원을 선택한다. 타브순서의 첫 창문부품을 선택 
하고 그다음 타브순서의 다음 창문부품을 선택하는 조작을 모든 창문부품들이 요구하는 
타브순서번호를 가질 때까지 반복한다. 오유를 범하였으면 첫 창문부품을 두번 련속 누 
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르고 다시 시작한다. 타브순서방식을 끝내려면 Esc 를 누른다. 변경을 취소하려면 타브 
순서 방식을 끝내 고 취소한다. 

Tools | Set Buddy 를 찰칵하여 (또는 F 12 을 눌러서 ) 짝패 를 표식 자로 설정 한다. 
그다음 표식자를 선택 하고 짝패 로 하려 는 창문부품까지 직선을 끌고간다. 마우스단추를 
놓으면 짝패가 설정된다. 

Tools|Buttons|PushButton 을 선택 하고 픔을 선택 하여 종우에 PushButton 을 배 치 한다. 
Tools|Buttons|ToolButton 을 선택 하고 폼을 선택 하여 폼우에 ToolButton 을 배 치 한다. 
Tools|Buttons|RadioButton 을 선택 하고 픔을 선택하여 종우에 RadioButton 을 배 치한다. 
ButtonGroup 안에 RadioButton 들을 배 치 하여 아가 그룹안의 오직 하나의 RadioButton 이 한 
번에 동작상태 로 될수 있다는것을 자동적 으로 담보한다. 

Tools|Buttons|CheckBox 를 선택 하고 폼을 선택하여 폼우에 CheckBox 를 배 치한다. 
Tools|Containers|GroupBox 를 선택 하고 좀을 선택 하여 좀우에 GroupBox 를 배 치 한다. 
Tools|Containers|ButtonGroup 을 선택하고 픔을 선택하여 좀우에 ButtonGroup 를 배치한다. 
Tools|Containers|Frame 을 선택 하고 좀을 선택하여 픔우에 Frame 을 배 치한다. 
Tools|Containers|TabWidget 를 선택 하고 좀을 선택하여 폼우에 TabWidget 를 배 치한다. 
타브를 추가 혹은 삭제 하려 면 타브창문부품을 오른쪽 단추로 찰칵하고 Add Page 혹은 
Remove Page 를 선택한다. 

Tools|Views|ListBox 를 선택 하고 폼을 선택 하여 폼우에 ListBox 를 배 치 한다. 
Tools|Views|ListView 를 선택 하고 폼을 선택하여 폼우에 ListView 를 배 치한다. 
Tools|Yiews|Icon View 를 선택 하고 좀을 선택 하여 좀우에 IconView 를 배 치 한다. 
Tools|Views|Table 을 선택 하고 좀을 선택하여 폼우에 Table 을 배 치한다. 
Tools|Database|DataTable 을 선택 하고 종을 선택하여 좀우에 DataTable 을 배 치한다. 
Tools|Database|DataBrowser 를 선택 하고 좀을 선택 하여 종우에 DataBrowser 를 배 치 한다. 
Tools|Database|DataView 를 선택 하고 픔을 선택 하여 폼우에 DataView 를 배 치 한다. 
Tools|Input|LineEdit 를 선택 하고 폼을 선택하여 폼우에 LineEdit 을 배 치한다. 

Tools|Input|SpinBox 를 선택 하고 종을 선택 하여 종우에 SpinBox 를 배 치 한다. 

Tools|Input|DateEdit 를 선택 하고 폼을 선택하여 폼우에 DateEdit 를 배 치한다. 

Tools|Input|TimeEdit 를 선택 하고 폼을 선택하여 폼우에 TimeEdit 를 배 치한다. 

Tools|Input|DateTimeEdit 를 선 택 하고 폼을 선택하여 폼우에 DateTimeEdit 을 배 치한다. 
Tools|Input|TextEdit 를 선택 하고 폼을 선택하여 종우에 TextEdit 을 배 치한다. 
Tools|Input|ComboBox 를 선택 하고 좀을 선택 하여 종우에 ComboBox 을 배 치 한다. 
Tools|Input|Slider 를 선택 하고 폼을 선택하여 종우에 Slider 을 배 치한다. 
Tools|Input|ScrollBar 를 선택 하고 폼을 선택하여 폼우에 Scrollbar 을 배 치한다. 
Tools|Input|Dial 을 선택 하고 폼을 선택하여 폼우에 Dial 을 배 치한다. 
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Tools|Display|Te 차 Label 을 선택 하고 품을 선택하여 픔우에 Te 산 Label 을 배 치한다. 
Tools|Display|PixmapLabel 을 선택 하고 픔을 선택하여 픔우에 PixmapLabel 을 배 치한다. 
Tools|Display|LCDNumber 를 선택 하고 픔을 선택하여 픔우에 LCDNumber 을 배 치한다. 
Tools|Display|Line 을 선택 하고 폼을 선택하여 폼우에 Line 을 배 치한다. 
Tools|Display|ProgressBar 를 선택 하고 폼을 선택 하여 픔우에 ProgressBar 을 배 치 한다. 
Tools|Display|TextBrowser 를 선택 하고 픔을 선택하여 픔우에 TextBrowser 을 배 치한다. 
Tools|Custom|Edit Custom Widgets 를 선택하여 Edit Custom Widgets 대 화칸을 펼 친 다. 
Tools|Custom| 을 선택 하고 폼을 선택 하여 폼우에 Custom Widget 를 배 치 한다. 
Tools|Custom|Edit Custom Widgets 를 리 용하여 창문부품을 창조한 경 우에 만 이 차림 표선 
택이 나타난다. 

Tools|Configure Toolbox 를 선택하여 Configure Toolbox 대 화칸을 펼 친 다. 

6. Lay out 차림표 



QQQ Lay Out Horizontally Ctrl+H 

= Lay Out Vertically Ctrl+L 

^ Lay Out in a Grid Ctrl+G 

y 斗 y Lay Out Horizontally (in Sfilitter) 

Lay Out Vertically (in Splitter) 

쳤 ) Break Layout Ctrl+B 

_ Add Spacer 

그림 1-75. Layout 차림표 

Layout 차림표는 Alt+L 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 

Layout | Adjust Size 를 선택하여 (또는 Ctrl+J 를 눌러서) 권고된 크기로 창문부품 
의 크기를 조절한다. 

Layout | Lay Out Horizontally 를 선택 하여 (또는 Ctrl+H 를 눌러서) 선택된 창문 
부품 혹은 배치들을 배치한다. Shift+Click 를 리용하여 각 창문부품 혹은 배치를 선택하 
고 이 차림표선택을 지정하여 그것들을 수평으로 묶는다. 흔히 복잡한 창문부품들에 대 
하여 Object Explorer 창문의 Widgets 타브에서 창문부품과 배치들을 눌러서 그것들을 
선택하는것이 가장 간단하다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 수 
평으로 배치된다. 

Layout | Lay Out Vertically 를 선택하여 (또는 Ctrl+L 을 눌러서) 선택된 창문부품 
들을 배치한다. Shift 를 누르고 찰칵하여 매개 창문부품 혹은 배치를 선택한 다음 이 차 
림표항목을 선택하여 그것들을 수직으로 묶는다. 흔히 복잡한 창문부품들에 대하여 
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Object Explorer 창문의 Widgets 타브에서 창문부품과 배치들을 눌러서 그것들을 선택 
하는것 이 가장 간단하다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 수직으 
로 배치된다. 

Layout | Lay Out in a Grid 를 선택 하여 (또는 0: rl + G 를 눌러서) 선택된 창문부품 
들을 살창으로 배치한다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 살창으 
로 배치된다. 

Layout | Lay Out Horizontally (in Splitter ) 를 선택하여 선택된 창문부품이 나 배 
치 들의 매 개 사이 에 분할기 ( splitter ) 를 주어 서 배 치 한다. Shift 를 누르고 찰칵하여 각 창 
문부품이나 배치를 선택하고 이 차림표항목을 선택하여 그것들을 수평으로 묶는다. 흔히 
복잡한 창문부품들에 대하여 Object Explorer 창문의 Widgets 타브에서 창문부품과 배 
치들을 눌러서 그것들을 선택하는것이 가장 간단하다. 

Layout | Lay Out Vertically (in Splitter ) 를 선택 하여 선택된 창문부품이 나 배 치 
들의 매개사이에 분할기를 주어서 배치한다. Shift 를 누르고 찰칵하여 각 창문부품이나 
배치를 선택하고 이 차림표항목을 선택하여 그것들을 수직으로 묶는다. 흔히 복잡한 창 
문부품들에 대하여 Object Explorer 창문의 Widgets 타브에서 창문부품과 배치들을 눌 
리서 그것들을 선택하는것이 가장 간단하다. 

Layout | Break Layout 를 선택하여 (또는 Ctrl + B 를 눌러서) 배치를 파피한다. 배 
치를 누르고 이 항목을 선택하면 배치가 삭제된다. 

Layout | Add Spacer 를 선택하여 폼에 너무 많은 공간을 가지는 창문부품들에 수 
직 혹은 수평수축자를 추가한다. 수축자는 배치에서 여유공간을 소비한다. 

7. Preview 차림표 



그림 1-76. Preview 차림표 

Preview 차림표는 Alt + P 에 의해 호출되며 다음과 같은 차림표선택을 제공한다. 
Preview | Preview Form 을 선택 하여 (또는 Ctrl + T 를 눌러서) Qt Designer 에서 
종을 미 리보기한다. 

Preview | ... in Windows Sty 노을 선택 하여 Windows 형 식 으로 종을 미 리 보기 한다. 
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Preview |... in Motif Style 을 선택 하여 Mottf 형식으로 폼을 미리 보기 한다. 
PreviewI...in CDE Style 을 선택하여 CDE 형식으로 폼을 미리보기한다. 
Preview | ... in Motif Plus Style 을 선택 하여 Mo 社 f Plus 형식으로 폼을 미리 보기 한다. 
Preview | ... in Platinum Sty 노을 선택 하여 Pla 仕 num 형 식 으로 픔을 미 리 보기 한다. 
Preview|...in SGI Style 을 선택하여 SGI 형식으로 폼을 미리보기한다. 

8. Window 차림표 


Close Ctrl+F4 

Close All 

Next 

Ctrl+F6 

Previous 

Ctrl+Shifl+F6 

lile 


Cascade 


Views 

► 

Toolbars 

► 

1 MulticlipForm 

[V 2 Forml 



그림 1-77. Window 차림표 


Window 차림표는 Alt + W 에 의 해 호출되며 다음과 같은 차림표선택 을 제공한다. 

Window | Close 를 선택하여 (또는 Ctrl + F 4 를 눌러서) 현재 작업중인 창문을 닫는다. 

Window | Close All 을 선택하여 현재 열려져 있는 창문들을 모두 닫는다. 

Window | Next 를 찰칵하여 (또는 Ctrl + F 6 을 눌러서) 다음 창문을 작업창문으로 
만든다. 순서는 창문이 열려진 순서이다. 

Window | Previous 를 선택하여 (또는 Ctrl + Shift + F 6 을 눌러서) 이전 창문을 작업 
창문으로 만든다. 그 순서는 창문이 열려진 순서이다. 

Window | Tile 을 선택하여 열려진 모든 파일들과 폼들을 나란히 배치하여 매개 창 
문을 볼수 있게 한다. 

Window | Cascade 를 선택하여 열려진 모든 파일과 몸들을 각 창문의 제목띠가 보 
이도록 서로 겹쌓아서 탄창에 넣는다. 

Window | Views|Project Overview 를 선택 하여 Project Overview 창문을 보이 게 
하거나 이미 보인다면 그것을 숨긴다. 창문이 현재 보이면 검사표식이 그 차림표의 이 
름옆에 나타난다. 

Window | Views | Property Editor/Signal Handlers 를 선택 하여 Property 
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Editor/Signal Handlers 창문을 보이게 하거나 이미 보이면 숨긴다. 창문이 현재 보이 
면 검사표식이 그 차림표의 이름옆에 나타난다. 

Window | Views | Object Explorer 를 선택 하여 Object Explorer 창문이 보이게 하거 
나 이미 보이면 숨긴다. 창문이 현재 보이면 검사표식 이 그 차림표의 이름옆에 나타난다. 

Window | Views | Line Up 를 선택 하여 도구띠 들사이 의 여 유공간을 삭제 하고 도구띠 
들이 서로 옆에 오도록 배 치한다. 

Window | Toolbars!File 을 선택 하여 File 도구띠 단추들이 보이게 하거 나 그것들이 
이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 에 나타 
난다. 

Window | Toolbars!Edit 를 선택 하여 Edit 도구띠 단추들이 보이게 하거 나 그것들이 
이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 에 나타 
난다. 

Window | Toolbars | Search 를 선택 하여 Search 도구띠 단추들이 보이 게 하거 나 그 
것 들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 
에 나타난다. 

Window | Toolbars | Layout 를 선택 하여 Layout 도구띠 단추들이 보이 게 하거 나 그 
것 들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 
에 나타난다. 

Window | Toolbars | Tools 를 선택하여 Tools 도구띠 단추들이 보이게 하거 나 그것 
들이 이 미 보이 면 숨긴 다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 에 
나타난다. 

Window | Toolbars|Bu 竹 ons 를 선택 하여 Buttons 도구띠 단추들이 보이게 하거나 
그것 들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름 
옆에 나타난다. 

Window | Toolbars | Containers 를 선택 하여 Containers 도구띠 단추들이 보이 게 
하거 나 그것들이 이미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검사표식 이 그 차림 표 
의 이름옆에 나타난다. 

Window | Toolbars | Views 를 선택 하여 Views 도구띠 단추들이 보이 게 하거 나 그것 
들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 에 
나타난다. 

Window | Toolbars!Database 를 선택하여 Database 도구띠 단추들이 보이 게 하거 나 
그것 들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름 
옆에 나타난다. 

Window | Toolbars!Input 를 선택 하여 Input 도구띠 단추들이 보이게 하거 나 그것 
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들이 이미 보이면 숨긴다. 도구띠단추가 현재 보이면 검사표식이 그 차림표의 이름옆에 
나타난다. 

Window | Toolbars | Display 를 선택 하여 Display 도구띠 단추들이 보이 게 하거 나 
그것들이 이 미 보이면 숨긴다. 도구띠단추가 현재 보이면 검사표식 이 그 차림 표의 이름 
옆에 나타난다. 

Window | Toolbars | Custom 을 선택하여 Custom 도구띠 단추들이 보이게 하거나 그 
것 들이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 
에 나타난다. 

Window | Toolbars | Help 를 선택 하여 Help 도구띠 단추들이 보이 게 하거 나 그것 들 
이 이 미 보이 면 숨긴다. 도구띠단추가 현재 보이 면 검 사표식 이 그 차림 표의 이 름옆 에 나 
타난다. 

Window | Toolbars | Line Up 를 선택 하여 도구띠 들사이 의 여 유공간을 삭제 하고 도구 
띠들이 서로 옆에 오도록 배 치 한다. 

Window|n - 현재 열린 파일들과 폼들에 번호가 지정되여 표시된 차림표항목들중 
하나를 선택하고 그것을 펼친다. 


9. Help 차림표 


Contents 

FI 

Manual 

Ctrl+M 

About... 


About Qt... 


失 ? What’s This? 

Shift+Fl 


그림 1-78. Help 차림표 

Help 차림 표는 Alt+H 에 의 해 호출되며 다음과 같은 차림 표선택 을 제공한다. 

Help | Contents 를 선택하여 (또는 犯을 눌러서) 직결방조를 제공하는 Qt Assistant 
응용프로그람을 펼친다. 직결방조는 문맥에 의존하므로 자세한 정보를 요구하는 항목을 
행편집 칸에 입력하면 Qt Assistant 는 그것 이 유효인 경우 자동적으로 탐색 한다. 

Help | Manual 을 선택하여 (또는 Ctrl+M 을 눌러서) Qt Assistant 응용프로그람을 
열고 방조문서를 표시한다. 

Help | About 를 선택하여 판번호와 허가정보를 주는 About Qt Designer 대화칸을 
펼친다. 
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Help|About 어를 선택하여 Qt 에 대한 정보를 제공하는 대화칸을 펼친다. 

Help | What's This ? 를 선택하여 마우스지적자와 련결된 작은 물음표를 표시한다. 
정보를 더 알고싶은 기능우에서 마우스를 누르면 그 기능에 대한 정보를 가진 뭐여나오 
기차림표가 나타난다. 


제11절. 도구[[ I 단추 

Qt Designer 의 도구띠 단추는 공통기 능에 대 한 고속호출을 제 공한다. 도구띠 단추들 
은 여러개의 도구띠들로 그룹화된다. 도구띠들은 왼쪽에 도구띠를 최소화하기 위하여 선 
택 할수 있는 손잡이 ( handle ) 들을 가지 고있 다. 최소화된 도구띠 들은 바로 차림 표띠 아래 
에 나타나는 손잡이들을 가지고있다. 이 손잡이를 선택하여 도구띠가 차지하였던 마지막 
위 치로 되돌아갈수 있다. 도구띠의 손잡이를 끌기하여 도구띠를 도구띠 령역안의 다른 위 
치로 옮길수 있다. 도구띠들은 도구띠령역의 밖으로 완전히 끌고나가서 독립적인 도구류 
동창문 (tool dock window ) 으로 만들수 있 다. 도구류동창문을 숨기 려 면 그 닫기 단추를 
찰칵한다. 숨은 도구류동창문을 되살리려면 도구령역을 오른쪽 단추로 선택하고 되살러 
려는 도구류동창문의 이름을 선택한다. 

1. File 도구띠단추 

jj Q 觸 圖 | metric _■ 3 

그림 1-79. File 도구단추 

New 를 찰칵하여 (또는 Ctrl + N 를 눌러 서 ) 새 프로젝 트，폼 혹은 파일을 창조한다. 
이 선택은 New File 대화칸을 펼친다. 

◦ pen 을 찰칵하여(또는 Ctrl + ◦를 눌러서) 현존 프로젝트，폼 혹은 파일을 연다. 
이 단추는 파일들을 선택하는데 사용되는 File Open 대화칸을 펼친다. 

Save 를 찰칵하여(또는 Ctrl + S 를 눌러서) 프로젝트，폼 혹은 파일들을 보관한다. 
픔이나 파일들이 없는 새 프로젝트에 대하여 Save 를 선택하여 완료하기전에 프로젝트를 
보관한다. 새 픔들에 대하여 Save 를 선택하면 Save Form As 대화칸이 나타난다. 

Ac 仕 ve Project 를 선택하여 현재 열려져있는 프로젝트의 이름들을 표시하고 프로젝 
트이름을 하나 선택하여 프로젝트들사이를 절환한다. 

2. Edit 도구띠단추 

그림 1-80. Edit 도구단추 
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Undo 를 찰칵하여(또는 Ctrl + Z 를 눌러 서 ) 하나의 조작을 취 소한다. 수행 된 마지 막 
조작의 이 름이 이 도구띠단추의 도구암시안의 Undo 단어 뒤 에 나타난다. 

Redo 를 찰칵하여(또는 Ctrl + Y 를 눌러서) 하나의 조작을 재시행한다. 수행된 마지 
막 조작의 이름이 이 도구띠단추의 도구암시의 Redo 단어뒤에 나타난다. 

Cut 를 찰칵하여(또는 Ctrl + X 를 눌러서) 현재 종이 나 파일로부터 선택 항목을 삭제 
하고 그것을 오려둠판에 복사한다. 

Copy 를 찰칵하여(또는 Ctrl + C 를 눌러서) 현재 종이 나 파일로부터 선택 항목을 오 
려둠판에 복사한다. 

Paste 를 찰칵하여 (또는 Ctrl + V 를 눌러서) 오려 둠판으로부터 현재 폼이 나 파일에 로 
선택항목을(있으면) 붙이기한다. 


3. Search 도구띠 단추 

J 松 ! | 

그림 1-81. Search 도구단추 

Find 를 찰칵하여 (또는 Ctrl + F 를 눌러서 ) Find Text 
대화칸을 펼친다. 

Find Incremental 을 찰칵하여 (또는 Alt + I 를 눌러서) 
Find 도구띠단추옆에 배 치된 본문칸에 유표를 배 치 한다. 본 
문칸에 문자를 입력할 때마다 Qt Designer 는 파일에서 처 
음으로 출현하는 본문을 강조표시한다. Enter 건을 눌러서 
다음 본문으로 이행한다. 찾으러는 단어를 발견하였으면 
Esc 건을 눌러서 편집기에 유표를 배치한다. 

4. Tools 도구띠단추 

Tools 도구띠단추들은 도구띠 들 (Qt 3.1 이 전)과 새 
로운 Toolbox 에서 사용할수 있다. Qt 3.1 에서 tools 
도구띠들은 은폐되고 Toolbox 가 표시된다. Toolbox 
는 그룰으로 분할되는데 그룹은 제 일 자주 사용하는 창 
문부품들을 포함하는 Common Widgets 이다. 원래의 
도구띠 설정 을 더 좋아한다면 Windows | Toolbars 를 선 
택하고 문맥차림 표에서 표시하려 는 도구띠 들을 선택하 
여 도구띠들을 호출할수 있다. 

Toolbox 는 도구단추들의 형을 서술하는 범주 
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그림 1-82. Toolbox 















( category ) 를 포함한다. 범주이름을 선택하여 그 범주안의 도구단추들을 호출할수 있다. 
범 주안의 창문부품을 리 용하려 면 창문부품을 선택 하여 그것 을 동작하게 한다. Toolbox 
의 오른쪽 구석안의 표를 선택 하여 닫을수 있 다. Toolbox 를 다시 표시 하려 면 
Window | Views | Toolbox # 선택 한다. 

폼에 갈은 종류의 창문부품 실례로 여러개의 누름단추를 여러개 추가하려면 그 창 
문부품의 도구띠단추를 두번 련속 찰칵한다. 그다음 폼을 누를 때 마다 새 창문부품이 추 
가된다. Pointer 도구띠 단추를 찰칵하여 이 방식을 완료한다. 

1) Tools 


그림 1-83. Tools 


Pointer 를 찰칵하여 (또는 F 2 을 눌러서) 선택된 위 자드도구띠 단추의 선택을 해제 한 
다. Pointer 는 또한 창문부품도구띠 단추를 두번 련속 눌러 서 새 창문부품들의 삽입 을 
중지하는데 리용된다. Esc 건을 누르면 임의의 시각에 지적자를 복귀할수 있다. 

Connect Signals and Slots 를 찰칵하여 (또는 F 3 을 눌러서) 신호와 처 리부를 련결 
한다. 그때 창문부품을 선택하고 련결선을 련결하려는 창문부품(혹은 폼)까지 끌고간다. 
마우스단추를 놓으면 View and Edit Connec 吐 ons 대화칸이 나타난다. 

Tab Order 를 찰칵하여 (또는 F 4 를 눌러서) 건반초점을 받아들일수 있는 모든 창문 
부품들에 대하여 타브순서를 설정 한다. 이 도구띠단추를 찰칵하고 창문부품들의 결에 나 
타나는 수값이 있는 푸른색원을 선택한다. 타브순서의 첫 창문부품을 선택하고 그다음 
타브순서의 다음 창문부품을 선택하는 조작을 모든 창문부품들이 요구하는 타브순서번호 
를 가질 때까지 반복한다. 오유를 범하였으면 첫 창문부품을 두번 련속 누르고 다시 시 
작한다. 타브순서 방식을 끝내 려면 Esc 를 누른다. 변경을 취소하려면 타브순서 방식을 끝 
내고 취소한다. 

Set Buddy 를 찰칵하여 (또는 F 12 을 눌러서) 짝패를 표식자로 설정한다. 그다음 
표식자를 선택하고 짝패로 하려는 창문부품까지 직선을 끌고간다. 마우스단추를 놓으면 
짝패가 설정된다. 

2) Buttons 

PushButton 을 찰칵하고 폼을 선택하여 픔에 Pushbutton 을 배 치한다. 

ToolButton 을 찰칵하고 종을 선택하여 좀에 Toolbutton 을 배치한다. 

RadioButton 을 선택하고 종을 선택하여 폼우에 RadioButton 을 배치한다. 
ButtonGroup 안에 RadioButton 들을 배치하여 아가 그룹안의 오직 하나의 
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RadioButton 이 한번에 동작상태로 될수 있다는것을 자동적으로 담보한다. 
CheckBox 를 찰칵하고 폼을 선택하여 폼에 CheckBox 를 배 치한다. 



Common Widgets 
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그림 1-84. Buttons 
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그림 1-85. Containers 


3) Containers 

GroupBox 를 찰칵하고 픔을 선택 하여 폼에 GroupBox 를 배 치 한다. (그림 1- 85) 
ButtonGroup 를 찰칵하고 픔을 선택하여 폼에 Bu 竹 onGroup 을 배치한다. 

Frame 을 찰칵하고 폼을 선택하여 폼에 Frame 을 배 치한다. 

TabWidget 를 선택하고 픔을 선택하여 폼우에 TabWidget 를 배치한다. 타브를 추 
가 혹은 삭제 하려면 타브창문부품을 오른쪽 단추로 찰칵하고 Add Page 혹은 Remove 
Page 를 선택한다. 

4) Views 

ListBox 를 찰칵하고 폼을 선택하여 폼에 ListBox 를 배치 한다. (그림 1_86) 
ListView 를 찰칵하고 폼을 선택하여 폼에 ListView 를 배치한다. 

Icon View 를 찰칵하고 폼을 선택하여 폼에 IconView 를 배치 한다. 

Table 을 찰칵하고 폼을 선택하여 폼에 Table 을 배치한다. 
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그림 1-87. Database 


5) Database 

DataTable 을 찰칵하고 폼을 선택 하여 픔에 DataTable 을 배 치 한다. (그림 1-87) 
DataBrowser 를 찰칵하고 폼을 선택하여 픔에 DataBrowser 을 배치한다. 
DataView 를 찰칵하고 폼을 선택하여 폼에 DataView 을 배치한다. 

6) Input 
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그림 1-88. Input 도구단추 

LineEdit 를 찰칵하고 품을 선택하여 픔에 LineEdit 를 배 치한다. 

SpinBox 를 찰칵하고 폼을 선택하여 픔에 SpinBox 를 배치한다. 

DateEdit 를 찰칵하고 폼을 선택하여 픔에 DateEdit 를 배 치한다. 

TimeEdit 를 찰칵하고 폼을 선택하여 폼에 TimeEdit 를 배 치한다. 
DateTimeEdit 를 찰칵하고 픔을 선택하여 픔에 DateTimeEdit 를 배치한다. 
TextEdit 를 찰칵하고 픔을 선택하여 폼에 TextEdit 를 배치한다. 
ComboBox 를 찰칵하고 픔을 선택하여 픔에 ComboBox 를 배치한다. 
Slider 를 찰칵하고 픔을 선택하여 픔에 Slider 를 배치한다. 

ScrollBar 를 찰칵하고 픔을 선택하여 픔에 Scrollbar 를 배 치한다. 

Dial 을 찰칵하고 폼을 선택하여 픔에 Dial 을 배 치한다. 
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7) Display 



그림 1-89. Display 도구단추 

TextLabel 을 찰칵하고 픔을 선택하여 폼에 TextLabel 을 배 치한다. 
PixmapLabel 을 찰칵하고 폼을 선택하여 픔에 PixmapLabel 을 배치한다. 
LCDNumber 를 찰칵하고 픔을 선택하여 픔에 LCDNumber 를 배 치한다. 
Line 을 찰칵하고 픔을 선택하여 픔에 Line 을 배치한다. 

ProgressBar 를 찰칵하고 픔을 선택하여 픔에 ProgressBar 를 배치한다. 
TextBrowser 를 찰칵하고 픔을 선택하여 픔에 TextBrowser 을 배 치한다. 
8) Custom 
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B My Custom Widget 

그림 1-90. Custom Widget 도구단추 
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My Custom Widget 를 찰칵하고 폼을 선택 하여 폼에 Custom Widget 를 배 치 한다. 
이 도구띠단추는 Tools | Custom | Edit Custom Widgets 를 사용하여 사용자정 의 창문부 
품을 창조한 경우에만 나타난다. 

9) Layout 도구띠 단추 


■ 1 經 I- H [ 

그림 1-91. Layout 도구단추 

Adjust Size 를 선택 하여 (또는 Ctrl + J 를 눌러서) 요구하는 크기 로 창문부품의 크기 
를 조절한다. 

Lay Out : Horizontally 를 선택하여 (또는 Ctrl + H 를 눌러서) 선택된 창문부품 혹 
은 배치들을 배치한다. Shift 를 누르고 찰칵하여 각 창문부품 혹은 배치를 선택하고 이 
차림표선택을 지정하여 그것들을 수평으로 묶는다. 흔히 복잡한 창문부품들에 대하여 
Object Explorer 창문의 Widgets 타브에서 창문부품과 배치들을 눌러서 그것들을 선택 
하는것이 가장 간단하다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 수평으 
로 배치된다. 

Lay Out Vertically 를 선택 하여 (또는 Ctrl + L 을 눌러서) 선택된 창문부품들을 배 치 
한다. Shift 를 누르고 찰칵하여 매개 창문부품 혹은 배치를 선택한 다음 이 차림표항목을 
선택하여 그것들을 수직으로 묶는다. 흔히 복잡한 창문부품들에 대 하여 Object Explorer 
창문의 Widgets 타브에서 창문부품과 배치들을 눌러서 그것들을 선택하는것이 가장 간단 
하다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 수직으로 배치된다. 

Lay out in a Grid 를 선택 하여 (또는 Ctrl + G 를 눌러서) 선택된 창문부품들을 살창으 
로 배치한다. 오직 한개의 창문부품이 선택되면 그 자식창문부품들이 살창으로 배치된다. 

Lay Out Horizontally (in Splitter ) 를 선택 하여 선택 된 창문부품이 나 배 치 들의 매 
개 사이 에 분할기 ( splitter ) 를 주어 서 배 치 한다. Shift 를 누르고 찰칵하여 각 창문부품이 
나 배치를 선택하고 이 차림표항목을 선택하여 그것들을 수평으로 묶는다. 흔히 복잡한 
창문부품들에 대하여 Object Explorer 창문의 Widgets 타브에서 창문부품과 배치들을 
눌러서 그것들을 선택하는것이 가장 간단하다. 

Lay Out Vertically (in Splitter ) 를 선택하여 선택된 창문부품이나 배치들의 매 
개사이에 분할기를 주어서 배 치한다. Shift 를 누르고 찰칵하여 각 창문부품이 나 배 치를 
선택하고 이 차림표항목을 선택하여 그것들을 수직으로 묶는다. 흔히 복잡한 창문부품들 
에 대하여 Object Explorer 창문의 Widgets 타브에서 창문부품과 배 치들을 눌러서 그것 
들을 선택하는것 이 가장 간단하다. 

Break Layout -1- 선택하여 (또는 Ctrl + B 를 눌러서) 배치를 파괴한다. 배치를 누르 
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고 이 항목을 선택하면 배치가 삭제된다. 

Add Spacer 를 선택 하여 폼에 너 무 많은 공간을 가지는 창문부품들에 수직 혹은 수 
평수축자를 추가한다. 수축자는 배치에서 여유공간을 차지한다. 

5. Help 도구띠단추 

H 

그림 1-92. Help 도구단추 

What’s This ? 를 선택하여 마우스지적자와 련결된 작은 물음표를 표시한다. 정보를 
더 알고싶은 기능우에서 마우스를 누르면 그 기능에 대 한 정보를 가진 튀 여 나오기 차림표 
가 나타난다. 


제12절. 대화칸 

이 절에서는 Qt Designer 의 매개 대화칸에 대하여 설명한다. 

1. Menu 대화칸 

1) Qt Designer New/Open 대화칸 



그림 1-93. Qt Designer New/Open 

Qt Designer 를 기동하면 Qt Designer New / Open 대화칸이 열린다. 이 대화칸은 
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Qt Designer 를 기동하여 무엇을 하려고 하는가에 따라서 사용하기 위 한 3개의 타브를 
포함한다. 

- New File / Project 타브 

이 타브는 Qt Designer -1- 기 동할 때 기 정 으로 되 여있 다. 새 프로젝 트를 기 동하거 
나 혹은 창문으로부터 적당한 그림기호를 선택하여 파일을 창조할 때 선택한다. 사용할 
수 있는 각이한 파일형에 대한 자세한 정보는 다음 항을 참고하시오. 

다음번에 이 대화칸을 숨기려면 " Don’t show this dialog in the future " 검사칸 
을 설정하고 Qt Designer 를 기동한다. 

- Open File / Project 타브 



그림 1-94. Open File/Project 

이 타브를 선택하여 이 미 존재하는 파일 이 나 프로젝 트를 꺼 낸 다. 타브는 현재 등록 
부와 기정과일형을 보여준다. 다른 등록부를 선택하려면 Look In 켤합칸을 선택한다. 파 
일을 선택 하면 그 이름이 File Name 복합칸에 나타난다. 다른 파일형을 선택 하려면 File 
Type 복합칸을 선택 한다. Create New Folder 도구띠 단추를 찰칵하여 새 등록부를 창조 
한다. List View 도구띠단추를 찰칵하여 이름만 보여주는 목록에 홀더와 파일들을 표시 
한다. Details 도구띠 단추를 찰칵하여 폴더 와 파일 들을 그 이 름，형，날자, 속성 들과 함 
께 표시한다. Size , Type , Date , 또는 Attributes 렬제목을 선택 하여 폴더 혹은 파일들 
을 정 렬한다. 

◦ K 를 찰칵하여 선택된 파일을 연다. Cancel 을 찰칵하여 새 파일을 열지 않고 대화 
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칸을 닫는다. 

- Recently Opened 타브 

이 타브는 창문에 최근에 연 파일들이나 프로젝트들을 모두 현시한다. 파일이나 프 
로젝트를 선택하고 OK 를 찰칵하여 연다. 

2. File 대화칸 


1 살 루 _ New File _ i_ □ 신 


□ 



函 

函 

【1 


Dialog 

Wizard 

Widget 


m 

© 

O 

Main Window 

Configuration Dialog 

Dialog with Buttons 

Dialog with Buttons 



(Bottom) 

(Right) 

函 

Q 

Q 

Q 

Tab Dialog 

C++ Source File 

C++ Header File 

C++ Main-File 




(main.cpp) 

Help | 


| 

OK | Cancel | 


名 


그림 1-95. New File 

1) New File 대 화칸 

FilelNew 를 선택하여 (혹은 Ctrl + N 을 눌러서) New File 대화칸을 펼친다. 이 대화 
칸은 선택할수 있는 4종의 파일들을 제공한다. 즉 C ++ 프로젝트, 폼, 원천파일, 그리고 
기본파일. 

Insert Into 내 리펼침복합칸은 현재 프로젝트에 기정으로 되 여있는 열려진 프로젝트 
들을 렬거한다. 이 복합칸에 표시된 프로젝트에 새 파일들을 추가한다. 각이한 프로젝트 
에 새 파일을 추가하려면 Insert Into 복합칸에서 사용하려는 프로젝트를 선택한다. 

Dialog 파일형은 New File 대화칸이 펼처질 때 기정으로 선택된다. 사용하려는 파일 
형을 선택하고 OK 를 찰칵하여 창조한다. Cancel 을 찰칵하여 새 파일을 창조하지 않고 
대 화칸을 닫을수 있 다. C ++ 프로젝 트를 선택 하면 Insert Into 복합칸은 허 용되 지 않으므로 
현존프로젝트에 새로운 C ++ 프로젝트를 삽입할수 없다. 

C ++ Project 를 선택 하여 새 프로젝 트를 시 작한다. 이 선택은 Project Se 竹 ings 대 화 
칸을 펼친다. C ++ 프로젝트들은 . pro 파일로서 보관되며 여기에는 Qt Designer 가 프로젝 
트들을 관리하기 위하여 요구하는 정보들이 포함된다. Qt Designer 에서 자기 프로젝트 
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에 폼을 추가할 때 그것은 자동적으로 프로젝트파일의 FORMS 절에 추가된다. .pro 파일 
은 프로젝 트에서 사용된 폼들 (.ui 파일들)의 목록을 포함한다. Qt Designer 는 .ui 파일 (실 
례로 form , ui ) 들을 읽고쓴다. uic (사용자대면부롬과일러)는 .ui 파일로부터 머리부파일 
(실 례 로 form , h ) 과 실현파일(실 례 로 form . cpp ) 을 둘다 창조한다. 

Dialog 을 선택하여 일반대화칸폼을 창조한다. 전형적으로 이 형의 폼은 사용자에게 
환경선택을 제시하거나 관련된 선택모임(실례로 인쇄기설정대화칸와 탐색 및 교체대화 
칸)을 제시하는데 리용된다. 

Wizard 를 선택하여 위자드폼을 창조한다. 위자드는 일련의 대화칸폐지들로 이루어 
지는 특수한 형태의 입력대화칸이다. 위자드의 목적은 사용자가 어떤 과정을 한걸음씩 
추적하여 일감을 자동화하도록 사용자를 방조하는것이다. 위자드는 사람들이 배우기 힘 
들거나 수행하기 힘든 복잡한 과제나 드물게 제기되는 과제들에 사용할수 있다. 처음에 
위자드픔은 하나의 대화칸폐지로 구성된다. 오른쪽 단추를 리용하여 문맥차림표를 선택 
하고 추가적인 폐지들을 첨부하고 페지제목들을 변경한다. 

Widget 를 선택 하여 기초클라스가 QDialog 가 아니 라 QWidget 인 폼을 창조한다. 

Main Window 를 선택 하여 Main Window Wizard 를 펼친다. 이 위자드는 작용과 
차림표선택, 사용자가 작용을 호출할수 있는 도구띠를 창조하는데 리용된다. 이 폼은 전 
형 적 인 기 본창문형 식 응용프로그람을 창조하는데 사용된 다. 

Configuration Dialog 를 선택하여 왼쪽에 목록칸, 폼을 꽉 채우는 타브창문부품 
그리고 Help 와 OK , Cancel 단추들을 가지는 폼을 창조한다. 

Dialog with Buttons ( Bottom ) 좀은 폼의 바닥에 기 정단추들이 있는 형 판이다. 

Dialog with Buttons ( Right ) 좀은 종의 오른쪽에 기 정단추들이 있는 형 판이다. 

Tab Dialog 픔은 중심창문부품으로서 타브창문부품과 함께 바닥에 Help , OK , 
Cancel 단추들이 있다. 

C ++ Source File 을 선택 하여 빈 C ++ 파일을 새 로 창조한다. 이 파일은 그것 을 보관 
할 때 자동적으로 프로젝트에 추가된다. 

C ++ Header File 을 선택하여 빈 C ++ 머 리부파일을 새로 창조한다. 이 파일은 그것 
을 보관할 때 자동적 으로 프로젝트에 추가된다. . 

C ++ Main File 을 선택 하여 기본 main.cpp 파일을 자동적으로 창조하는 Configure 
Main-File 대 화칸을 펼친다. C ++ 기 본파일은 열 려있는 프로젝 트가 없으면 가능한 선택 이 
아니다. 또한 이 파일형은 프로젝트를 창조하지 않고서는 main.cpp 파일을 창조할수 없 
으므로 Qt Designer New/Open 대 화칸에서 는 사용할수 없다. 

2) Configure Main-File 대화칸 
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그림 1-96. Configure Main-File 

File | New | C ++ Main-File 을 선택하여 Configure Main-File 대화칸을 펼친다. 이 
대화칸을 리용하여 기본파일과 그 폼들의 환경을 구성한다. 

기 정 파일 이 름을 변경 하려 면 Filename 행 편집 칸에 그것 을 입 력 한다. 폼을 선택 하고 
행편집칸으로부터 그것 을 선택 함으로써 응용프로그람의 기 본폼으로 사용한다. 

◦K 를 찰칵하여 환경구성을 받아들이면 Qt Designer 가 기정의 main.cpp 파일을 창 
조한다. Cancel 을 찰칵하여 대화칸을 닫는다. 

자료기지프로그람작성자들을 위한 알아두기 : Qt Designer 로 main . cpp 파일을 창조하면 
이 파일 은 createConnectionsO 함수를 포함하지 않는다. 자료기 지련결 에 는 사용자이 름과 통과 
암호가 필요하기때문에 이 함수를 포함하지 않는다. 결과로서 Qt Designer 에서 정확히 예 
견하는 응용프로그람들은 자체의 자료기지 련결함수를 실현하지 않으면 실행 할수 없다. 

3) File Open 대화칸 
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그림 1-97. File Open 


FilelOpen 을 선택하여 ( Ctrl + O 를 눌러서) Open 대화칸을 연다. 이 대화칸에 의하 
여 현존파일들을 연다. 

◦ pen 대화칸은 현재등록부와 기정파일형을 표시한다. 다른 등록부를 선택하려면 
Look In 복합칸을 선택한다. 파일을 선택하면 그 이름이 File Name 복합칸에 나타난다. 
다른 파일형 을 선택 하려 면 File Type 복합칸을 선택 한다. Create New Folder 도구띠 단 
추를 찰칵하여 새 등록부를 창조한다. List View 도구띠단추를 찰칵하여 목록에 폴더 와 
파일들의 이름만 표시 한다. Details 도구띠 단추를 찰칵하여 폴더와 파일 이름，그러 고 그 
크기，형 , 속성들을 표시한다. Size , Type , Date , 혹은 Attributes 렬의 머 리부를 선택 
하여 폴더 혹은 파일들을 정렬한다. 

◦ pen 을 눌러서 선택된 파일을 연다. Cancel 을 찰칵하여 새 파일을 열지 않고 대 
화칸을 닫는다. 

알아두기 : Windows 에서는 System File 대화칸이 사용된다. 

4) Save As 대화칸 
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그림 1-98. Save As 대화칸 

File|Save As 를 선택 하여 Save As 대화칸을 펼친다. 이 대화칸에 의 하여 등록부에 
파일들을 보관한다. 

Save As 대화칸은 현재 등록부와 기정과일형을 표시한다. 다른 등록부를 선택하려 
면 Look In 복합칸을 찰칵한다. 파일을 선택하면 그 이름이 File Name 복합칸에 나타난 
다. 다른 파일형을 선택하려면 File Type 복합칸을 찰칵한다. Create New Folder 도구 
띠 단추를 찰칵하여 새 등록부를 창조한다. List View 도구띠 단추를 찰칵하여 목록에 폴 
더 와 파일들의 이름만 표시 한다. Details 도구띠 단추를 찰칵하여 폴더 와 파일 이 름, 그러 
고 그 크기 , 형 , 날자, 속성들을 표시 한다. Size , Type , Date , 혹은 Attributes 렬제 목 
을 선택하여 폴더나 과일들을 정렬한다. 

Save 를 선택하여 선택된 파일을 보관한다. Cancel 을 찰칵하여 파일을 보관하지 않 
고 대화칸을 닫는다. 

알아두기 : Windows 에서는 System File 대화칸이 사용된다. 

5) Save Form As 대화칸 
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그림 1-99. Save Form As 

폼을 보관할 때 File|Save As 를 선택 하여 Save Form As 를 연다. 

Save Form As 대화칸은 현재등록부와 기정 파일형을 표시 한다. 다른 등록부를 선택 
하려면 Look In 복합칸을 찰칵한다. 파일을 선택하면 그 이름이 File Name 복합칸에 나 
타난다. 다른 파일형을 선택하려면 File Type 복합칸을 찰칵한다. Create New Folder 
도구띠단추를 찰칵하여 새 등록부를 창조한다. List View 도구띠단추를 찰칵하여 폴더 와 
파일들의 이 름만 목록에 표시 한다. Details 도구띠 단추를 찰칵하여 폴더 와 파일 이 름, 그 
리고 그 크기，형, 날자, 속성들을 표시한다. Size, Type, Date, 혹은 Attributes 렬제 
목을 선택하여 폴더나 파일들을 정렬한다. 

Save 를 눌러서 선택된 폼을 보관한다. Cancel 을 찰칵하여 픔을 보관하지 않고 대 
화칸을 닫는다. 

6) Create Template 대화칸 



그림 1-100. Create Template 대화칸 
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File|Create Template 를 선택 하여 Create Template 대화칸을 펼친다. 이 대화칸 
을 리용하여 형판을 창조한다. 

Template Name 행편집칸의 기정은 New Template 이 다. 다른 이름으로 변경하려 
면 그것을 행편집 칸에 입력한다. Baseclass for Template 흐름띠를 누르고 형판의 기초 
클라스를 선택한다. 

Create 를 선택하여 형판을 창조한다. Cancel 을 찰칵하여 형판을 창조하지 않고 대 
화칸을 닫는다. 

형판을 창조하면 그것 이 New File 대화칸에 나타난다. 형판는 비슷한 폼을 대 량적 
으로 생성해 야 할 때 혹은 자기 종들에 형타를 만들려 고 할 때 사용할수 있다. 

3. Edit 대화칸 

1) Edit Functions 대화칸 



그림 1-101. Edit Functions 대화칸 

Edit | Slots 를 선택 하여 Edit Func 仕 ons 대 화칸을 펼친다. 이 대 화칸에 의 하여 신호와 결 
합하여 객 체 들사이 의 통신을 제 공하는데 쓰이 는 처 리 부나 함수들을 편집 하거 나 창조한다. 

이 대화칸이 펼쳐지면 모든 현존처리부와 함수들이 목록보기에 표시된다. 렬제목 
Function , Return Type , Specifier , Access , Type 그리고 In Use 는 렬거되는 각 함 
수에 대하여 자세한 정보를 제공한다. 임의의 렬제목을 선택하여 함수들을 정렬한다. 새 
함수를 창조하려면 New Func 仕 on 단추를 찰칵한다. 새 함수는 기정이름을 가지므로 
Function 행 편집 칸에 새 이 름을 입 력 하여 교체 하여 야 한다. Return Type 도 역 시 기 정 
이 므로 행 편집칸에 입 력 하여 변경 할수 있다. Specifier 혹은 Access 를 변경 하려 면 복합 
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칸을 누르고 필요한 지정자나 호출을 선택한다. 함수의 형 (함수 혹은 처리부)을 변경하 
려면 Type 복합칸을 선택한다. 함수를 삭제하려면 삭제하려는 함수를 선택하고 Delete 
Function 단추를 찰칵한다. 

◦ K 를 찰칵하여 함수에 대한 변경을 모두 보관한다. Cancel 을 찰칵하여 함수에 대 
한 변경을 보관하지 않고 대화칸을 닫는다. 

2) View and Edit Connec 仕 ons 대화칸 



그림 1-102. View and Edit Connections 대화칸 
Edit | Connections 를 선택 하여 View and Edit Connec 吐 ons 대화칸을 펼친다. 이 
대화칸도 역시 임의의 창문부품을 오른쪽 단추로 선택하여 호출된다. 이 대화칸을 리용 
하여 신호-처리부련결을 표시하고 편집한다. 

이 대화칸이 열리면 모든 현존련결이 목록칸에 표시된다. 렬제목 Sender , Signal , 
Receiver , 그리고 Slot 는 각 련결에 대한 자세한 정보를 제공한다. 렬제목을 선택하여 
련결을 정렬한다. 새 련결을 추가하려면 New 단추를 찰칵한다. 련결의 Sender , Signal , 
Receiver 그러고 Slot 를 지정하려면 련결의 적당한 마당들을 누르고 복합칸에서 선택 
한다. 련결을 삭제하려면 련결을 선택하고 Delete 단추를 찰칵한다. 현재 폼을 위한 전 
용처리부를 편집하려면 현재 선택된 련결에서 Receiver 로서 폼을 선택하고 Edit Slots 
단추를 찰칵한다. 이것은 Edit Func 吐 ons 대화칸을 펼친다. 

◦ K 를 찰칵하여 련결에 대한 변경을 모두 보관한다. Cancel 을 찰칵하여 련결에 대 
한 변경을 보관하지 않고 대화칸을 닫는다. 

3) Form Settings 대화칸 
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그림 1-103. Form Settings 대화칸 

Edit|Form Settings 를 선택 하여 Form Settings 대화칸을 펼친다. 이 대화칸을 리 
용하여 좀의 설정，픽스매프，그러고 배치속성을 보관한다. 

- Settings 

Settings 절 에 서 Class Name 행 편집 칸에 입 력 하여 창조한 클라스의 이 름을 변경 하거 
나 추가할수 있다. 기정이름은 폼이름이지만 변경 할수 있다. 또한 Comment 와 Author 
행편집칸에 본문을 입력하거나 그것들이 필요없다면 비워둘수 있다. 

- Pixmaps 

기정(프로젝트들에서)은 Project Imagefile 이 다. 이것은 권고하는 선택 이다. 화상 
은 자동적으로 조절되며 Qt Designer 를 리용하여 보조등록부에서 화상들을 기억하고 
uic 는 화상을 포함하는 코드와 필요한 지원코드를 생성한다. 매개 화상은 한번만 기억되 
며 여러 폼에서 리용할수 있다. 

Qt Designer 로 화상들을 조종하려고 하지 않는다면 (혹은 프로젝트를 사용하고있 
지 않는다면) Save Inline 혹은 Use Function 을 선택 한다. Save Inline 은 .ui 파일들 
에 픽스매프를 보관한다. 이 수법의 결합은 화상들이 사용되는 픔들에 그것들을 보관한 
다는것이며 이것은 화상들을 폼들에서 교차로 공유할수 없다는것을 의미한다. Use 
Function 을 선택하여 픽스매프의 적재에 자체의 그림기호적재기함수를 리용한다. Use 
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Function 행 편집 칸에 함수의 이 름(서 명 이 없 이 )을 입 력 한다. 이 함수는 픽 스매 프적재 를 
위하여 생성된 코드에서 리용된다. 자기의 함수는 화상이 요구될 때마다 픽스매프속성에 
입력한 본몬(실례로 화상이름)과 함께 호출된다. 

- Layouts 

Default Margin 스핀칸 혹은 Default Spacing 스핀칸을 선택하여 현재 폼의 기정배 
치설정을 변경한다. 

배치의 기정여백과 공백용의 값들을 동적으로 얻기 위하여 생성한 코드에서 함수를 
리용하려면 Use Functions 검사칸을 설정한다. Margin 과 Spacing 행편집칸들에서 여백 
과 공백을 엄는데 사용해야 할 함수이름(서명이나 paran 仕 ieses 없이)을 지정한다. 

◦ K 를 찰칵하여 몸설정에 대한 변경을 받아들인다. Cancel 을 찰칵하여 변경을 보관 
하지 않고 대화칸을 닫는다. 

4) Preferences 대 화칸 

Edit | Preferences 를 선택 하여 Preferences 대화칸을 펼친다. 이 대화칸에는 
General 선택용 타브가 있다. C ++ Editor 플라그인을 가지고있으면 대화칸에는 C ++ 
Editor 타브도 있다. 



그림 1-104. Preferences - General 타브 


General 타브에는 Background 와 Grid , General , File Saving , Plugin Paths 
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부분들이 있다. 

Background 부분은 기 정 으로 Pixmap 로 되 여있 다. 기 정 값을 변경 하려 면 Pixmap 
라지 오단추옆의 Select a Pixmap 단추를 찰칵하여 Choose a Pixmap. .. 대화칸을 펼친 
다. Color 라지오단추를 찰칵하여 배경을 픽스매프대신에 색으로 변경할수도 있다. 
Color 라지오단추의 오른쪽에 있는 Choose a Color 단추를 찰칵하여 Select Color 대화 
칸을 펼친다. 

Grid 부분에는 폼에서 살창을 전용화하기 위한 선택이 있다. Grid 부분에 배치된 
Show Grid 검사칸은 기정으로 선택된 상태이다. Qt Designer 를 리용하는 개발자들은 
거의 항상 Qt 의 배치를 리용하여 자기의 폼들을 설계하고 드문히 살창을 리용한다. 폼 
이 고정크기와 위치를 가지는 창문부품들을 리용하여 창조되는 경우에 드물게 살창이 제 
공된다. Show Grid 가 선택되여있으면 살창의 모양을 전용화할수 있다. 그것이 선택되 
지 않았으면 Grid 부분이 허용되지 않는다. Snap to Grid 검사칸도 역시 기정 으로 설정되 
여있다. 그것이 선택되여있을 때 창문부품들은 X|Y 해상도를 리용하여 점에 배치된다. 
그것이 검사되지 않을 때 Grid-X 와 Grid-Y 스핀칸들은 허용되지 않는다. Grid 표와 
Grid Y 스핀칸들을 선택하여 모든 폼용으로 살창설정을 전용화할수 있다. 

General 타브의 General 부분에는 4 개의 검사칸이 있다. Restore last workspace 
on startup 검사칸을 설정하여 Qt Designer 의 창문과 도구 띠들의 크기와 위치를 보관한 
다. Qt Designer 가 다음에 기동할 때 창문과 도구 띠들이 그 마지막 위치에 복귀된다. 
Show Splash Screen on startup 검사칸을 설정하여 응용프로그람을 기동할 때 Qt 
Designer 기동화면을 표시 한다. Disable Database Auto-Edit in Preview 검사칸을 설 
정하여 자료기지창문부품들과 작업할 때 련결되는 자료기지에서 자료를 갱신하거나 삭제 
하는 기 능을 허 용하지 않는다. Show Toolbutton Label 를 선택 하여 Qt Designer 의 도 
구 띠단추들아래 에 본문표식 자가 나타나게 한다. 

Qt Designer 가 파일을 자동적 으로 보관하게 하려면 Enable Auto Save 검사칸을 
설정 하고 시격 을 설정 한다. 

Qt Designer 는 플라그인경로에서 발견한 플래그인들을 적재한다. 자기의 전용플라 
그인경 로들을 추가하려 면 그것 들을 플라그인경 로 다중행편집칸에 입 력한다. (한행 에 하 
나씩) 

- C++ Editor 타브 
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그림 1-105. Preferences - C ++ Editor 타브 

C ++ Editor 타브는 편집기를 전용화하기 위한 선택을 제공한다. Syntax 
Highlighting 부분은 문법이 편집기에 표시되는 방법을 변경 하게 한다. Element 목록칸 
을 누르고 한개 요소를 선택한다. Family 목록칸을 선택하여 그 요소의 서체형식을 변경 
한다. Size 스핀칸을 통하여 서체크기를 선택한다. 서체는 대응하는 검사칸을 눌러서 
Bold , Italic , 혹은 Underline 로 바끌수 있다. 사용되는 모든 서체는 Standard 요소로 
부터 얻어지므로 모두에 사용되는 서체를 변경하려면 Standard 요소를 변경한다. Color 
단추를 찰칵하여 Select Color 대 화칸을 펼친다. 매 개 요소를 변경 하였을 때 Preview 행 
편집칸에서 변경을 볼수 있다. 

Options 부분에 는 기 정 으로 검 사되 여있는 Wordwrap , Completion , Parentheses 
Matching 검사칸들이 있다. 검사칸들을 선택하여 그것들을 해제할수 있다. 

◦ K 를 찰칵하여 Preferences 대화칸에 대한 변경을 받아들인다. Cancel 을 찰칵하 
여 변경을 보관하지 않고 대화칸을 닫는다. 
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4. Project 대화칸 

1) Add 대화칸 



그림 1-106. Add 대화칸 

Project | Add File 을 선택하여 Add 대화칸을 펼친다. 이 대화칸을 리용하여 현재 
프로젝트에 파일들을 추가한다. 

Add 대화칸의 기정값은 등록부와 파일형 이다. 다른 등록부를 선택하려면 Look In 
복합칸을 찰칵한다. 파일을 선택하면 그 이름이 File Name 복합칸에 나타난다. File 
Type 복합칸을 리 용하여 다른 파일 형 을 선택 한다. Create New Folder 도구 띠 단추를 찰 
칵하여 새 등록부를 창조한다. List View 도구 띠단추를 찰칵하여 폴더 와 파일들의 이 름 
만 목록에 표시 한다. Details 도구 띠 단추를 찰칵하여 폴더 와 파일 이 름, 그리 고 그 크기 , 
형, 날자, 속성들을 표시한다. Size , Type , Date , 혹은 Attributes 렬제목을 선택하여 
폴더나 과일들을 정렬한다. 

◦ pen 을 찰칵하여 선택한 파일을 연다. Cancel 을 찰칵하여 파일을 열지 않고 대화 
칸을 닫는다. 
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2) Manage Image Collec 切 on 대 화칸 



그림 1-107. Manage Image Collection 대화칸 


Project | Image Collection 을 선택 하여 Manage Image Col lection 대화 칸을 펼친 
다. 이 대화칸을 리 용하여 프로젝트의 화상들을 표시하고 새 화상들을 추가하거나 화상 
들을 삭제한다. 

화상을 추가하려면 Add 단추를 찰칵하여 Choose Images ... 대화칸을 펼친다. 

Choose Images 대화칸은 현재등록부와 기정파일형을 표시한다. 다른 등록부를 선 
택하려면 Look In 복합칸을 찰칵한다. 파일을 선택하면 그 이름이 File Name 복합칸에 
나타난다. 다른 파일형을 선택하려면 File Type 복합칸을 찰칵한다. 다른 파일들을 선택 
하여 대화칸의 오른쪽에 배 치된 창문에서 화상들을 미 리볼수 있다. Create New Folder 
도구띠 단추를 찰칵하여 새 등록부를 창조한다. List View 도구띠 단추를 찰칵하여 폴더 와 
파일들의 이름만 목록에 표시 한다. Details 도구띠 단추를 찰칵하여 폴더와 파일 이름, 그 
리고 그 크기, 형，날자，속성들을 표시한다. Size , Type , Date , 혹은 Attributes 렬제 
목을 선택하여 폴더나 파일들을 정렬한다. Open 을 선택하여 선택된 파일을 연다. 
Cancel 을 찰칵하여 파일을 열지 않고 대화칸을 닫는다. 

그림기호보기로부터 화상을 삭제하려면 화상을 선택하고 Delete 단추를 찰칵한다. 

화상집합에 대한 변경이 즉시 적용된다. Close 단추를 찰칵하여 대화칸을 닫는다. 
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3) Edit Database Connections 대화칸 



그림 1-108. Edit Database Connections 대화칸 

Project |Database Connections 를 선택 하여 Edit Database Connections 대 화칸을 
펼친다. 이 대화칸을 리용하여 자기의 프로젝트를 자료기지에 련결하거나 현재 련결을 
편집 한다. 

New Connection 을 선택 하여 새 로운 자료기 지련결을 창조한다. 하나의 자료기 지 
를 사용하는 응용프로그람들에서는 기정련결이름 ( default ) 를 사용하는것이 아마 관례로 
되여있다. 하나이상의 자료기지를 사용한다면 매개에 유일이름이 주어져야 한다. 구동프 
로그람은 Driver 복합칸에서 선택 되 여 야 한다. 자료기 지이 름은 Database Name 복합칸에 
서 선택 하거 나 입 력 할수 있다. 자료기지이 름，사용자이 름, 통과암호와 호스트이 름은 자 
료기지체계관리자에 의해 제공되여야 한다. Connection 정보가 끝나면 Connect 를 선택 
한다. 련결이 이루어지면 련결이름이 대화칸의 왼쪽에 있는 목록칸에 나타난다. 

련결을 삭제하려면 목록칸안의 련결을 선택하고 Delete Connec 社 on 단추를 찰칵한다. 

Close 를 선택 하여 Database Connections 대화칸을 닫는다. 

4) Project Settings 대화칸 

Project | Project Settings 를 선택 하여 Project Settings 대화칸을 펼친 다. 이 대화 
칸을 리용하여 프로젝트설정을 변경한다. 

- Settings 타브 
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그림 1-109. Project Settings - Settings 타브 

Settings 타브는 프로젝 트에 대 한 정 보를 표시 한다. Project File 행 편집 칸은 기 정 으로 프 
로젝트이름이다. 이름을 변경하려면 행편집칸에 새 이름을 입력하거나 Project File 옆에 
배치된 생략단추를 찰칵하여 Save As 대화칸을 펼친다. Language 복합칸은 비표시상태로 
되 여 있다. Database File 행 편집 칸의 이름을 변경 하려면 행편집 칸에 새 이름을 입 력하거나 
생략단추를 찰칵하여 Save As 대화칸을 펼친다. 

- C ++ 타브 



그림 1-110. Project Settings - C ++ 타브 

C ++ 타브를 선택 하여 qmake 선택 을 변경 한다 (4 장 참고) . Template 복합칸을 리 용하 
여 응용프로그람이나 서고를 선택하고 응용프로그람이나 서고를 건설하기 위한 
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makefile 들을 창조한다. Config 복합칸에서 모든 가동환경 혹은 특정한 가동환경용의 프 
로젝 트환경 과 콤파일 러 선택 을 설정 한다. 행 편집칸에서 Config 값을 입 력 한다. 

알아두기 : Unix 에 서 는 기 정 으로 공유서 고로 되 여있 다. Windows 에 서 공유서 고를 
요구한다면 기정환경지령의 끝에 dll 이라고 입력하고 Template 복합칸에서 1比를 선택 
하게 한다. Libs 복합칸에서 가동환경을 선택한다. 행편집칸에 서고들을 입력한다. 
Defines 복합칸에서 가동환경을 선택한다. Defines 값들은 콤파일러의 앞처리프로그람 마 
크로로서 추가된 다. 행 편집칸에 서 Defines 값을 입 력 한다. Includepa 比 i 복합칸에 서 가동 
환경을 선택한다. Includepa 社!는 프로젝트를 콤파일할 때 머리부파일들을 탐색하여야 
하는 등록부들을 지 정한다. 행 편집칸에 서 Includepa 仕 I 값들을 입 력 한다. 

◦ K 를 찰칵하여 프로젝트설정에 대한 변경을 받아들인다. Cancel 을 찰칵하여 프로 
젝트설정을 변경하지 않고 대화칸을 닫는다. 

5. Search 대화칸 

1) Find Text 대화칸 



그림 1-111. Find Text 

Search | Find 을 선택 하여 ( Ctrl + F 을 눌러서) Find Text 대 화칸을 펼친다. 이 대 화칸 
을 리용하여 프로젝트파일에서 지정된 본문을 탐색한다. 

파일에서 요구되는 본문을 찾기 위하여 Find 복합칸에 본문을 입 력한다. Op 仕 ons 절 
에서 임의의 한개 검사칸 혹은 모든 검사칸을 설정하여 탐색을 더욱 전문화할수 있다. 
Whole words only 검사칸을 선택하여 전체 단어의 람색을 제한한다. Case Sensitive 
를 선택 하여 복합칸에 입력한 본문과 동등한 본문을 탐색한다. Start at Beginning 을 선 
택하여 파일의 선두로부터 탐색을 시작한다. Direc 仕 on 절은 Forward 라지오단추와 
Backward 라지오단추를 제공하여 파일에서 탐색을 진행하려는 방향을 지정한다. Find 
단추를 찰칵하여 람색을 시작한다. 본문을 발견하면 그것은 파일에서 강조표시된다. 
Find 를 계속 눌러서 련이 어 놓여 있는 탐색본문을 찾는다. 
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Close 단추를 찰칵하여 대화칸을 닫는다. 
2) Replace Text 대화칸 



그림 1-112. Replace Text 

Search | Replace 을 선택 하여 (또는 Ctrl + R 를 눌러서 ) Replace Text 대 화칸을 펼친 
다. 이 대화칸을 리용하여 프로젝트파일안의 본문을 교체한다. 

본문을 교체하려면 Find 복합칸에 교체하려는 본문을 입력한다. Replace 복합칸에 새 
본문을 입력한다. Options 절의 검사칸들을 일부 혹은 전부 선택하여 람색방법을 선택할수도 
있 다. Whole words only 검 사칸을 선택 하여 전체 단어 에 대 한 탐색 을 제 한할수 있 다. Case 
Sensitive 를 선택하여 복합칸에 입력한 본문과 등가한 본문을 탐색한다. Start at 
Beginning 을 선택하여 파일의 선두로부터 람색을 시작한다. Direc 仕 on 절은 Forward 라지 
오단추와 Backward 라지 오단추를 제공하여 파일에서 탐색을 수행 하는 방향을 지정 한다. 

Replace 단추를 찰칵하여 본문을 탐색 및 교체한다. 본문이 발견될 때 파일안에서 선 
택표시된다. Replace 단추를 찰칵하여 파일안에서 그 본문이 발생할 때마다 람색과 교체를 
계속한다. Replace All 단추를 찰칵하여 파일에서 모든 탐색 본문을 한번에 교체 한다. 

Close 단추를 찰칵하여 대화칸을 닫는다. 

3) Goto Line 대화칸 



그림 1-113. Goto Line 

Search I Goto line 을 선택 하여 (혹은 Alt + G 를 눌러 서 ) Goto Line 대 화칸을 펼 친 다. 
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이 대화칸을 리용하여 파일안의 지정행으로 이행한다. 

행번호를 선택하려면 Line 스핀칸에 번호를 입력하거나 스핀칸에서 올리와 내리화살 
표를 찰칵한다. Goto 단추를 찰칵한다. 유표는 파일의 행선두에 놓인다. 

Close 단추를 찰칵하여 대화칸을 닫는다. 

6. Tools 대화칸 

1) Edit Custom Widgets 대화칸 

Edit Custom Widgets 대화칸은 Tools | Custom|Edit Custom Widgets 를 선택 하 
여 호출된다. 이 대화칸을 리용하여 사용자정의창문부품을 창조한다. 

사용자정의창문부품은 코드로 창조된다. 사용자정의창문부품들은 현존창문부품들의 
결 합을 포함하지 만 기 능과 처 리부，신호들이 추가되 여있 다. 혹은 무로부터 사용자정 의 창 
문부품을 쓸수도 있으며 두개를 결합하여 만들수도 있다. 사용자정의창문부품은 흔히 다 
른 창문부품의 특수화(파생들라스) 혹은 함께 작업하는 창문부품들의 결합 혹은 이 두가 
지 수법의 결합이다. 특별한 환경에서 단지 창문부품들의 집합을 바란다면 그것들을 창 
조하는것은 가장 간단하며 그것들을 그름으로 선택하고 Qt Designer 에서 요구될 때 그 
것 들을 복사하여 붙이 기한다. 사용자정 의창문부품들은 일 반적 으로 현존창문부품 혹은 창 
문부품그룹에 새 기능을 추가하여야 할 때 창조된다. 새 창문부품을 추가하려면 New 
Widget 단추를 찰칵한다. Definitions Section 에서 새 창문부품추가에 대한 더 자세한 
정보를 볼수 있다. 사용자정의창문부품서술을 포함하는 파일을 적재하려면 Load 
Descrip 吐 ons 단추를 찰칵하여 Open 대화칸을 연다. 렬거된 사용자정의창문부품들의 서 
술을 보관하려면 Save Descriptions 단추를 찰칵하여 Save As 대화칸을 펼친다. 창문부 
품을 삭제하려면 목록칸에서 그 창문부품을 선택하고 Delete Widget 단추를 찰칵한다. 

Close 를 선택하여 Edit Custom Widgets 대화칸을 닫는다. 

- Definition 타브 

사용자정 의 창문부품을 창조하려 면 New Widget 를 선택한다. (그림 1-114) 이 미 그 
것 이 열 려 있으면 Definition 타브를 선택 한다. 행 편집칸에 입 력 하여 Class 이름을 
MyCustomWidget 로부터 유일 이 름으로 변경 해 야 한다. Headerfile 행 편집 칸에 입 력 하여 
이름을 변경하거나 리용하려는 머리부파일의 이름을 입력한다. 등록부에서 보관된 머리 
부파일 을 탐색 하려 면 Headerfile 행 편집 칸의 오른쪽에 있는 생 략단추를 찰칵하여 Open 
대화칸을 펼친다. Select Access 복합칸에서 파일을 포함하는 방법을 선택한다. 대역머 
리부파일은 각괄호 (<>) 를 리용하여 포함한다. 국부파일은 2중인용표를 리용하여 포함한 
다. 도구띠에서 자기 창문부품을 식별하는데 리용하려는 픽스매프가 있으면 Pixmap 표 
식 자의 오른쪽에 있는 생 략단추를 찰칵한다. 이것은 Choose a Pixmap 대화칸을 펼친다. 
Size Hint 스핀칸들에서 요구되는 창문부품크기를 선택한다. 요구되는 크기를 사용하지 
않으려고 한다면 스핀칸들에 -1/-1을 입 력 한다. Size Policy 복합칸들에서 창문부품의 
수직 크기 속성 들을 선택 한다. 자기 가 창조한 사용자정 의 창문부품이 다른 창문부품 (자식 ) 
들을 포함할수 있어 야 한다면 Container Widget 검사칸을 선택 한다. 

- Signals 타브 


198 





그림 1-114. Edit Custom Widgets - Definition 타브 



그림 1-115. Edit Custom Widgets - Signals 타브 
Signals 타브를 선택하여 선택된 사용자정의창문부품이 발생할수 있는 모든 신호목 
륵을 표시 할수 있다. 새 신호를 추가하려 면 New Signal 단추를 찰칵한다. Signal 행 편집 
칸을 선택하고 신호의 인수를 제공하고 유일이름을 준다. 목록칸에서 신호를 삭제하려면 
그 신호를 선택하고 Delete Signal 단추를 찰칵한다. 


- Slots 타브 
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그림 1-116. Edit Custom Widgets- Slots 타브 
Slots 타브를 선택하여 선택된 사용자정의창문부품용의 모든 처 리부들의 목록을 표시한 
다. Slot 나 Access 렬제목을 선택하여 목록칸안의 처 리부들을 정렬한다. 처 리부를 추가하려 
면 New Slot 단추를 찰칵한다. Slot 행 편집 칸을 선택하고 처 리부용인수를 제공하고 처 리부에 
유일이름을 준다. Access 복합칸에서 창문부품에 대하여 공개 혹은 보호호출을 선택한다. 목 
륵칸에서 처 리부를 삭제하려면 그 처 리부를 선택하고 Delete Slot 을 찰칵한다. 

- Properties 타브 



Load Descriptions... I 
Save Descriptions... I 


w Property I Delete Property I 


Property Name: |property 


Titpe: | String 三] 


그림 1-117. Edit Custom Widgets- Properties 타브 
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Properties 타브를 선택하여 선택된 창문부품의 속성목록을 표시한다. Property 나 
Type 렬제목을 선택하여 목록칸안의 속성들을 정렬한다. 속성을 추가하려면 New 
Property 단추를 찰칵한다. 속성의 기정이름을 변경 하려면 Property Name 행편집칸을 
선택한다. Qt 의 속성체계를 리용하여 클라스에 속성들을 실현하여야 한다. 속성형을 선 
택하려면 Type 복합칸을 찰칵한다. 목록칸에서 속성을 삭제하려면 그 속성을 선택하고 
Delete Property 단추를 찰칵한다. 

Close 를 선택하여 Edit Custom Widgets 대화칸을 닫는다. 

2) Configure Toolbox 대화칸 



그림 1-118. Configure Toolbox 

Tools|Configure Toolbox 를 선택 하여 Configure Toolbox 대화칸을 펼친다. 이 
대 화칸은 유효도구목록과 도구칸에 서 Common Widgets 범 주의 도구목록을 표시 하는데 
리용된다. Common Widgets 범주에 창문부품들을 추가하려면 Available Widgets 목록 
에서 창문부품을 선택하고 Add 를 찰칵한다. 선택된 창문부품이 현재 Common 
Widgets 범주에 나타난다. 창문부품을 Common Widgets 목록에서 삭제 하려면 창문부품 
을 선택하고 Remove 를 찰칵한다. Common Widgets 목록에서 창문부품을 우，아래로 
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이동하려면 올리 및 내리화살표들을 찰칵한다. 

◦ K 를 찰칵하여 도구칸에 환경구성을 받아들인다. Cancel 을 찰칵하여 대화칸을 닫는다. 

7. Help 대화칸 

1) About Qt Designer 대화칸 

Help | About 를 선택 하여 About Qt Designer 대화칸을 펼친다. 이 대 화칸은 판， 
허가항목，조건, 거부자와 같은 Qt Designer 에 대한 정보를 제공한다. 

대 화칸의 오른쪽웃구석 에 배 치 되 여있는 표를 선택 하여 대 화칸을 닫는다. 

2) About Qt 대화칸 

Help | About Qt # 선택하여 About Qt 대화칸을 펼친다. 이 대화칸은 Qt 에 대한 
정보를 계공한다. 

대 화칸의 제 목에 배 치 되 여있는 표를 선택 하여 대 화칸을 닫는다. 

8. Widget 대화칸 

1) Edit Text 대화칸 



그림 1-119. Edit Text 

Edit Text 대화칸은 다음의 창문부품들 즉 TextEdit , TextLabel , PixmapLabel 
를 오른쪽 단추로 선택하고 Edit Text 를 눌러서 펼친다. 

이 대화칸을 리용하여 형식도구띠와 차림표를 리용하는 자기의 본문에 HTML 형식 
화를 적용한다. 

◦ K 를 찰칵하여 본문과 형식화를 받아들인다. Cancel 을 찰칵하여 본문이나 형식화 
를 보관하지 않고 대화칸을 닫는다. 
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2) Edit Text 대화칸 



그림 1-120. Edit Text 

Edit Text 대화칸은 다음의 창문부품들 즉 PushButton , RadioButton , 
CheckBox , ToolButton 을 오른쪽 단추로 선택하고 Edit Text 를 눌러서 펼친다. 

이 대화칸을 리용하여 창문부품의 본문을 변경한다. 

◦ K 를 찰칵하여 본문에 대한 변경을 받아들인다. Cancel 을 찰칵하여 본문에 대한 
변경을 보관하지 않고 대화칸을 닫는다. 

3) Text 대화칸 



그림 1-121. Text 대화칸 

Text 대화칸은 LineEdit 창문부품을 오른쪽 단추로 눌러서 펼친다. 

이 대화칸은 행편집칸의 본문을 변경하는데 리용된다. 

◦ K 를 찰칵하여 본문에 대한 변경을 받아들인다. Cancel 을 찰칵하여 본문에 대한 
변경을 보관하지 않고 대화칸을 닫는다. 
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4) Title 대화칸 



그림 1-122. Title 대화칸 

Title 대 화칸은 다음의 창문부품들 즉 ButtonGroup 과 GroupBox 를 오른쪽 단추로 
선택하고 Edit Title 를 눌러서 펼친다. 

이 대화칸을 리용하여 행편집칸에 새로운 제목을 입력하여 선택된 창문부품의 제목 
을 변경한다. 

◦ K 를 찰칵하여 제목에 대한 변경을 받아들인다. Cancel 을 찰칵하여 제목을 변경하 
지 않고 대화칸을 닫는다. 

5) Page Title 대화칸 



그림 1-123. Page Title 대화칸 

Page Title 대화칸 TabWidget 를 오른쪽 단추로 선택 하고 Edit Page Title 를 눌러 
서 펼친다. 

이 대화칸을 리용하여 Tab 창문부품안의 매개 타브의 제목을 변경한다. 

◦ K 를 찰칵하여 새 폐지제목을 받아들인다. Cancel 을 찰칵하여 변경하지 않고 대화 
칸을 닫는다. 

6) Choose an Image 대화칸 
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그림 1-124. Choose an Image 

Choose an Image 대화칸에서 창문부품에서 리용하려는 화상을 선택한다. 

목록칸에서 화상을 선택하려면 화상을 선택하고 OK 를 찰칵한다. 화상을 추가하려 
면 Add 단추를 찰칵하여 Choose Images ... 대화칸을 펼친다. 화상을 삭제하려면 목록칸 
에서 화상을 선택하고 Delete 단추를 찰칵한다. 

Cancel 을 찰칵하여 화상을 변경하지 않고 대화칸을 닫는다. 

7) Edit Listbox 대화칸 



그림 1-125. Edit Listbox 

Edit Lis 比 iox 대화칸은 Lis 仕 )ox 창문부품을 오른쪽 단추로 선택하고 Edit 단추를 찰 
칵하여 기동한다. 
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이 대화칸을 리용하여 목록칸에 항목들을 추가하고 항목의 속성들을 변경한다. 

목록칸에 항목을 추가하려면 New Item 을 선택 한다. 항목의 기정이름을 변경 하려 면 
Item Properties 절 안의 Text 행 편집 칸을 선택 하고 항목의 새 이 름을 입 력 한다. Select a 
Pixmap 를 선택하여 Choose an Image 대화칸을 펼친다. 픽스매프를 선택하고 Delete 
Pixmap 단추를 찰칵하여 선택된 픽스매프를 삭제한다. 목록칸에서 항목을 삭제하려면 
그 항목을 선택하고 Delete 단추를 찰칵한다. 목록칸에서 항목을 우，아래로 이동하려면 
Move Up 혹은 Move Down 단추를 찰칵한다. Apply 를 선택하여 변경을 받아들인다. 

Apply 를 선택하여 목록칸 창문부품에 대한 변경을 받아들인다. 일단 변경을 받아 
들였으면 OK 를 찰칵하여 대화칸을 닫는다. Cancel 을 찰칵하여 변경을 보관하지 않고 
대화칸을 닫는다. 

8) Edit List view 

Edit List view 대화칸은 목록보기창문부품을 오른쪽 단추로 선택하고 Edit 를 눌러서 
기동한다. 

이 대 화칸을 리 용하여 목록보기 에 항목을 추가한다. Edit Listview 대 화칸에 는 두개 
의 타브가 있는데 하나는 항목용이고 다른 하나는 렬용이다. 

- Items 타브 



그림 1-126. Edit Listview - Items 타브 
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대 화칸은 기 정 으로 Items 타브로 되 여있 다. 이 타브를 리 용하여 목록보기 에 서 항목 
들을 추가，변경 혹은 삭제한다. 새 항목을 추가하려면 New Item 단추를 찰칵한다. 새 
항목은 목록칸의 꼭대기 에 표시된다. 현존항목에 보조항목들을 추가하려면 그 항목을 선 
택하고 New Subitem 단추를 찰칵한다. Column 스핀칸에서 항목본문 혹은 픽스매프를 
배 치 할 렬을 선택 한다. Text 행 편집칸을 선택 하여 렬의 본문을 입 력 하거 나 항목이 나 보 
조항목의 이름을 변경한다. 픽스매프를 선택하고 Delete Pixmap 단추를 찰칵하여 선택 
된 픽스매프를 삭제한다. 목록칸에서 항목을 삭제하려면 그 항목을 선택하고 Delete 단 
추를 찰칵한다. 계층준위에서 항목을 우아래로 이동하려면 Move Up 혹은 Move 
Down 단추를 찰칵한다. 항목을 한준위 우아래로 이동하려면 Move Left 혹은 Move 
Right 단추를 찰칵한다. 

- Columns 타브 



그림 1-127. Edit Listview - Columns 타브 

이 타브를 선택 하여 목록보기의 렬구성을 변경한다. 렬을 추가하려면 New 
Column 단추를 찰칵한다. 새 렬이 목록칸의 꼭대기에 표시된다. 렬이름을 변경하려면 
목록칸안의 렬을 선택하고 Text 행편집칸에서 새 이름을 입력한다. 픽스매프를 추가하려 
면 생략단추를 찰칵하여 Choose an Image 대화칸을 펼친다. 픽스매프를 삭제 하려면 
Delete Pixmap 단추를 찰칵한다. 렬이 마우스누르기에 응답하게 하려면 Clickable 검사 
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칸을 선택한다. 렬의 폭을 변경할수 있게 하려면 Resizeable 검사칸을 선택한다. 렬을 
삭제하려면 목록칸안의 렬을 선택하고 Delete Column 단추를 찰칵한다. 목록칸에서 우 
아래 로 렬을 이동하려 면 Move Up 혹은 Move Down 단추를 찰칵한다. 

Apply 를 선택하여 목록보기 창문부품에 대한 변경을 받아들인다. 일단 변경을 받 
아들였으면 OK 를 찰칵하여 대화칸을 닫는다. Cancel 을 찰칵하여 변경을 보관하지 않고 
대화칸을 닫는다. 

9) Edit Iconview 대화칸 



그림 1-128. Edit Iconview 

Edit Iconview 대화칸은 그림기호보기 창문부품을 오른쪽 단추로 선택하고 Edit . 를 
눌러서 펼친다. 

대화칸을 리용하여 그림기호보기로부터 항목들을 추가, 변경, 혹은 삭제할수 있다. 
그림기호보기에 항목을 추가하려면 New Item 단추를 찰칵한다. 항목의 이름을 변경하려 
면 Text 행 편집칸을 선택 하고 새 이 름을 입 력 한다. 픽 스매 프를 추가하려 면 생 략단추를 
찰칵하여 Choose an Image 대화칸을 펼친다. 픽 스매 프를 삭제 하려 면 Delete Pixmap 단 
추를 찰칵한다. 그림기호보기로부터 항목을 삭제하려면 그 항목을 선택하고 Delete 
Item 단추를 찰칵한다. 

Apply 를 선택하여 그림기호보기 창문부품에 대한 변경을 받아들인다. 일단 변경을 
받아들였으면 OK 를 찰칵하여 대화칸을 닫는다. Cancel 을 찰칵하여 변경을 보관하지 않 
고 대화칸을 닫는다. 


208 

















10) Edit Table 대화칸 

Edit Table 대화칸은 다음의 창문부품들 즉 Table 과 DataTable 을 오른쪽 단추로 
선택하고 Edit 를 눌러서 펼친다. 

이 대화칸을 리용하여 표에서 렬이나 행들을 추가，변경，혹은 삭제한다. 

- Column 타브 



그림 1-129. Edit Table - Columns 타브 


표에 렬을 추가하려면 New Column 단추를 찰칵한다. 표에서 렬을 삭제하려면 삭 
제하려는 렬을 선택하거나 Columns 목록칸에서 렬번호를 선택하고 Delete Column 단추 
를 찰칵한다. 렬이 름을 변경 하려 면 Label 행 편집칸을 선택 하고 다음 본문을 입 력 한다. 
픽 스매 프를 추가하려 면 생 략단추를 찰칵하여 Choose an Image 대화칸을 펼친다. 선택 된 
항목의 현재 렬에서 픽스매프를 삭제하려면 Delete Pixmap 단추를 찰칵한다. 목록칸에 
서 렬을 이동하려면 Move Up 혹은 Move Down 단추를 찰칵한다. 

- Rows 타브 
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그림 1-130. Edit Table - Rows 타브 

표에 렬을 추가하려면 New Row 단추를 찰칵한다. 표에서 행을 삭제하려면 표에서 
삭제하려는 행을 선택하거나 Rows 목록칸에서 행번호를 선택하고 Delete Column 단추 
를 찰칵한다. 행이름을 변경하려면 행 이나 행번호를 선택하고 Label 행편집칸에서 다음 
본문을 입 력 한다. 픽 스매 프를 추가하려 면 생 략단추를 찰칵하여 Choose an Image 대 화칸 
을 펼친다. 선택된 항목의 현재행으로부터 픽스매프를 삭제하려면 Delete Pixmap 단추 
를 찰칵한다. 목록칸의 한 행을 이동하려면 Move Up 혹은 Move Down 단추들을 찰칵 
한다. 

Apply 를 선택하여 표창문부품에 대한 변경을 받아들인다. 일단 변경을 받아들였으 
면 OK 를 찰칵하여 대화칸을 닫는다. Cancel 을 찰칵하여 변경을 보관하지 않고 대화칸 
을 닫는다. 
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9. Property Editor 대화칸 

1) Choose a Pixmap 대화칸 



그림 1-131. Choose a Pixmap 

Choose a Pixmap 대 화칸은 paletteBackgroundPixmap 혹은 속성 편집 기 의 픽 스매 
프속성옆의 단추를 찰칵하여 펼친다. 또한 다음과 같은 창문부품들 즉 PushButton , 
RadioButton , CheckBox , ToolButton 을 오른쪽 단추로 선택하여 펼칠수도 있다. 또 
한 이 대화칸은 다음의 창문부품들 즉 Table , DataTable , ListBox , ComboBox , 
ListView , IconView 를 오른쪽 단추로 선택 하고 Edit 를 누른 다음 Select a Pixmap 단 
추를 찰칵하여 호출할수도 있다. 

이 대화칸을 리용하여 현재 프로젝트에서 사용하려는 픽스매프를 선택한다. 

Choose a Pixmap 대화칸은 현재등록부와 기정파일형을 표시한다. 다른 등록부를 
선택 하려 면 Look In 복합칸을 찰칵한다. 파일을 선택 하면 그 이 름이 File Name 복합칸에 
나타난다. 다른 파일형을 선택하려면 File Type 복합칸을 찰칵한다. Create New 
Folder 도구띠 단추를 찰칵하여 새 등록부를 창조한다. List View 도구띠 단추를 찰칵하여 
폴더 와 파일 들의 이 름만 목록에 표시 한다. Details 도구띠 단추를 찰칵하여 폴더 와 파일 이 
름，그리 고 그 크기，형 , 날자, 속성 들을 표시 한다. Size , Type , Date 혹은 Attributes 
렬제목을 선택하여 폴더나 파일들을 정렬한다. 대화칸의 오른쪽에 배치된 미리보기칸에 
서 선택하는 픽 스매프 의 견본을 표시한다. 

◦ K 를 찰칵하여 픽 스매프 파일을 받아들인다. Cancel 을 찰칵하여 픽 스매프 파일을 선 
택 하지 않고 대화칸을 닫는다. 
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2) Select Color 대화칸 


Custom colors 

厂厂厂厂厂 r 厂厂 
厂 r r r 厂厂 r r 


■ 


Hue: 11 Red: [o 

Sat: [o Green: [o 

Val: fo Blue: |o 

I 


Add to Custom Colors 


그림 1-132. Select Color 

Select Color 대화칸은 paletteForegroundColor 옆의 단추나 속성편집기의 

pale 竹 eBackgroundColor 속성옆의 단추들을 눌러서 펼친다. 

이 대화칸을 리 용하여 색을 선택 하거나 조색 판을 창조한다. 

Basic Colors 절로부터 색을 선택하면 색견본이 대화칸의 바닥에 있는 작은 미리보 
기칸에 나타난다. 색견본의 오른쪽에 색스펙트르안에 색의 위치정보가 있는 행편집칸들 
을 보게 된다. 또한 더 큰 색스펙트르창문안의 +기호는 색의 위치를 보여준다. 또한 전 
용색들의 조색판을 창조할수도 있다. 전용색을 추가하는 두가지 방법 이 있다. 색스펙트 
르창문의 색을 선택한다. 창문아래의 작은 칸에 색이 나타날 때 색을 선택하고 그것을 
대 화칸의 Custom Color 절 안에서 빈칸들중 하나로 끌고간다. 또한 Basic Colors 절로부 
터 색들을 선택하여 끌고다닐수 있다. 색을 추가하는 다른 방법은 색이 선택되였을 때 
Add to Custom Colors 를 누르는것 이 다. 

◦ K 를 찰칵하여 Select Color 대화칸에 대한 변경을 받아들인다. Cancel 을 찰칵하 
여 색을 선택하지 않고 혹은 전용색들을 추가하지 않고 대화칸을 완료한다. 

3) Edit Palette 대화칸 
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| ᆻ 후 Edit Palette i O X] 

r Build Palette - 

3-D Effects: | 11 Background: | 11 Tune Palette... I 

「Preview - 

Select Palette: | Active Palette ^ 



Help | | OK | Cancel 


그림 1-133. Edit Palette 

Edit Palette 대화칸은 속성편집기의 조색판속성옆의 단추를 찰칵하여 펼친다. 

이 대화칸을 리용하여 현재 창문부품이나 폼의 조색판을 변경한다. 생성한 조색판 
을 리 용하거 나 각 색 그룹과 각 색의 역 할을 선택할수 있다. 조색 판은 미 리 보기절에서 각 
이 한 창문부품배 치 에 대 하여 시 험 할수 있 다. 

Build Palette 절은 조색판건설을 방조하는 3개의 단추를 포함한다. 3 -D Effects 단 
추를 찰칵하여 Select Color 대화칸을 펼친다. Background 를 선택하여 Select Color 
대화칸을 펼친다. Tune Palette 단추를 찰칵하여 Tune Palette 대화칸을 펼친다. 
Preview 절의 Select Palette 복합칸에서 미리볼 조색판을 선택한다. 

◦災를 찰칵하여 조색판에 대한 변경을 받아들인다. Cancel 을 찰칵하여 조색판에 대 
한 변경을 보관하지 않고 대화칸을 닫는다. 
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4) Tune Palette 대화칸 



그림 1-134. Tune Palette 

Tune Palette 대화칸은 창문부품의 조색판용기능들을 선택하는데 리용된다. 

Select Palette 복합칸에서 능동，비능동 혹은 금지하는 조색판의 선택들을 설정한 
다. Active Palette 를 선택하면 대화칸이 조색판설계에 쓰이는 3개의 범주를 표시한다. 
그 범 주들은 Auto , Central Color Roles , 그리 고 3 -D Shadow Effects 이 다. Inactive 
Palette 혹은 Disabled Palette 를 선택하면 모든 범주가 Auto 를 제외하고 금지로 된다. 
Auto 절의 검사칸들을 선택하여 능동조색판으로부터 능동 혹은 허용하지 않는 조색판들 
을 건설한다. 능동조색판에 대하여 Central color roles 복합칸에서 조색판의 색역할을 
선택한다. Choose Pixmap 단추를 찰칵하여 Choose a Pixmap 대화칸을 펼친다. Select 
Color 단추를 찰칵하여 Select Color 대화칸을 펼친다. 3 -D shadow effects 절의 Build 
from button color 검사칸을 설정하여 단추색으로부터 3- D 효과색을 계산할수 있게 한다. 
검사칸을 해제 하여 Choose 3 -D effect color role 복합칸이 가능하게 한다. 복합칸에서 
3- D 효과를 위한 색역할을 선택한다. Select Color 단추를 찰칵하여 Select Color 대화칸 
을 펼친다. 

◦ K 를 찰칵하여 조색판에 대한 변경을 받아들인다. Cancel 을 찰칵하여 조색판에 대 
한 변경을 보관하지 않고 대화칸을 닫는다. 
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5) Select Font 대화칸 



그림 1-135. Select Font 

Select Font 대화칸은 속성편집기의 서체속성옆의 단추를 찰칵하여 펼친다. 

이 대 화칸을 리 용하여 서 체 크기 와 형 식을 변경한다. 

Font 목록칸에서 서 체 형 을 선택한다. 현재 선택된 형 이 Font 목록칸우의 행편집칸에 
나타난다. Font Style 목록칸에서 서체의 형식을 선택한다. 목록칸에서 유효한것은 선택 
하는 서체형으로 제한된다. 모든 서체가 유효한 모든 형식을 가지는것은 아니다. 선택된 
형식은 Font Style 목록칸우의 행편집칸에 나타난다. Size 목록칸에서 서체의 크기를 선 
택 한다. 현재 선택된 크기는 Size 행 편집칸우의 행 편집 칸에 나타난다. Effects 절의 검 사 
칸들을 선택하여 선택된 서체에 대한 Strikeout 혹은 Underline 효과를 창조한다. 
Script 를 선택하고 쓰기형식을 설정한다. Sample 목록칸에 자기의 서체선택과 형식을 표 
시한다. 

◦ K 를 찰칵하여 서체에 대한 변경을 받아들인다. Cancel 을 찰칵하여 서체에 대한 
변경을 보관하지 않고 대화칸을 닫는다. 
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10. 통보칸 

1) Save Project Settings 대화칸 



그림 1-136. Save Project Settings 

Save Project Set 仕 ngs 통보칸은 보관안된 변경 이 있는 열려진 프로젝트에 대하여 
File | Close 혹은 File | Exit 를 눌러서 펼친다. 대화칸은 본문 ’Save changes to your 
project . pro ’? 을 표시한다. Yes 를 선택하여 변경을 보관한다. 프로젝트에 보관하지 못 
한 변경 이 있는 종이 있다면 Yes 를 선택 할 때 Save Form As 대화칸이 펼쳐진다. No 를 
선택하여 변경을 보관하지 않고 프로젝트를 닫는다. Cancel 을 찰칵하여 변경을 보관하 
지 않고 프로젝트를 닫는다. 

2) Save Form 대화칸 



그림 1-137. Save Form 

Save Form 통보는 여 러 가지 방법 으로 펼친다. 한가지 방법은 절대 로 보관되지 않았 
거나 이전에 보관되였는데 변경이 있는 폼에 대하여 FilelClose 를 선택하는것이다. 대 
화칸은 또한 절대로 보관되지 않았거나 이전에 보관되였는데 변경이 있는 폼에 대하여 
File | Exit 를 선택하여 펼칠수 있다. 대화칸은 ’Save Clianges to the Form ?’ 를 표시 
한다. Yes 를 선택하여 폼을 보관한다. 픔이 이전에 보관되지 않았다면 Save Form As 
대화칸이 열린다. No 를 선택하여 변경을 보관하지 않고 폼을 닫거나 이미 보관하지 않 
았는데 폼을 보관하지 않고 품을 닫는다. Cancel 을 찰칵하여 좀을 보관하지 않고 폼을 
닫거나 완료한다. 

11. Object Explorer 대화칸 

일부 대화칸은 Object Explorer 창문에서 유효한 선택들을 눌러서 펼친다. 

1) Edit Forward Declarations 대화칸 
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그림 1-138. Edit Forward Declarations 

Object Explorer 창문의 Source 타브에 서 Forward Declarations 폴더 를 오른쪽 단 
추로 선택하고 문맥 차림표에서 Edit 를 누르면 Edit Forward Declarations 대화칸이 펼 
쳐진다. 이 대화칸을 리용하여 원천코드에 선언들을 추가，편집, 혹은 삭제한다. 

새로운 선언을 추가하려면 Add 단추를 찰칵한다. 행편집칸이 나타나면 선언을 입력 
한다. 선언을 입력한 다음 Enter 를 누른다. 목록칸에서 선언을 삭제하려면 그 선언을 
선택하고 Remove 를 찰칵한다. 현존선언의 이름을 변경하려면 그 선언을 선택하고 
Rename 을 누른다. 유표가 행편집칸에 나타나면 이름을 변경할수 있다. 

Close 를 선택하여 Edit Forward Declarations 대화칸을 닫는다. 

2) Edit Includes (in Declaration ) 대화칸 



그림 1-139. Edit Includes (in Declaration ) 

Object Explorer 창문의 Source 타브에서 Includes (in Declaration ) 홀더를 오른 
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쪽 단추로 선택하고 문맥차림표에서 Edit 를 눌러서 Edit Includes (in Declarations ) 
대화칸을 펼친다. 이 대화칸을 리용하여 원천코드에 머리부를 추가, 편집，혹은 삭제할 
수 있다. 

새 머 리부를 추가하려면 Add 단추를 찰칵한다. 행편집칸이 나타나면 머 리부를 입력 
한다. 머리부를 입력한 다음 Enter 를 누른다. 목록칸에서 머 리부를 삭제하려면 머리부 
를 선택하고 Remove 를 누른다. 현존머리부의 이름을 변경하려면 머리부를 선택하고 
Rename 을 찰칵한다. 유표가 행편집칸에 나타나면 이름을 변경할수 있다. 

Close 을 선택하여 Edit Include (in Declara 仕 on ) 대화칸을 닫는다. 

3) Edit Includes (in Implementation ) 대화칸 



그림 1-140. Edit Includes (in Implementation ) 

Object Explorer 창문의 Source 타브에서 Includes (in Implementation ) 홀더를 
오른쪽 단추로 선택하고 문맥차림표에서 Edit 를 눌러서 Edit Includes (in 
Implementation ) 대화칸을 펼친 다. 이 대화칸을 리 용하여 원천코드에 머리 부를 추가, 
편집，혹은 삭제할수 있다. 

새 머 리 부를 추가하려 면 Add 단추를 찰칵한다. 행 편집칸이 나타나면 머 리 부를 입 력 
한다. 머 리부를 입 력한 다음 Enter 를 누른다. 목록칸에서 머 리부를 삭제 하려면 머 리부 
를 선택하고 Remove 를 누른다. 현존머리부의 이름을 변경하려면 머리부를 선택하고 
Rename 을 찰칵한다. 유표가 행편집칸에 나타나면 이름을 변경할수 있다. 

Close 을 선택 하여 Edit Include (in Implementation ) 대화칸을 닫는다. . 

4) Edit Class Variables 대화칸 
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그림 1-141. Edit Class Variables 

Object Explorer 창문의 Source 타브에 서 Class Variables 흘더 를 오른쪽 단추로 선 
택 하고 문맥 차림표에서 Edit 를 눌러서 Edit Class Variables 대화칸을 펼친다. 이 대화 
칸을 리용하여 원천코드에 클라스변수들을 추가, 편집, 혹은 삭제할수 있다. 

새 변수를 추가하려면 Add 단추를 찰칵한다. 행편집칸이 나타나면 변수를 입력한다. 
변수를 입력한 다음 Enter 를 누른다. 목록칸에서 변수를 삭제하려면 변수를 선택하고 
Remove 를 누른다. 현존변수의 이름을 변경하려면 변수를 선택하고 Rename 을 찰칵한 
다. 유표가 행 편집칸에 나타나면 이 름을 변경 할수 있 다. 

Close 를 선택 하여 Edit Class Variables 대화칸을 닫는다. 
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제 13 절. 위자드 

Qt Designer 에서 일부 도구 띠들과 차림표선택, 형판들은 위자 드를 기동하여 특정 
한 과제 들을 한걸 음씩 처 리 한다. 이 절 에 서 는 매 개 의 Qt Designer 위 자드에 대 하여 설 
명 한다. 

1. Main Window 위자드 

Main Window 위자드는 New File 대화칸의 Main Window 폼형판을 선택하여 기동한 
다. 이 위자드는 작용과 차림표선택 , 도구띠를 가지는 기 본창문을 창조하는데 리용한다. 

1) 유효한 차림표와 도구띠 



그림 1-142. Choose available menus and toolbars 위자드폐지 
Choose available menus and toolbars 위자드페지가 처음으로 나타난다. 이것은 
기정작용들인 File 작용과 Edit 작용, Help 작용을 제시한다. 매개 범주에 대하여 Qt 
Designer 가 련관된 작용들을 위 한 차림 표항목들과 도구 띠단추, 신호-처 리 부련결을 창조 
하도록 선택 할수 있다. 후에 작용, 차림 표항목, 도구 띠단추, 련결을 추가하거 나 삭제할 
수 있다. 검사칸들을 설정하거나 해제하여 자기가 좋아하는것을 선택할수 있다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. 

2) Setup 도구띠위자드 
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그림 1-143. Setup Toolbar 위자드페지 

Setup Toolbar 위 자드페지는 기정 작용범주로부터 선택 한 작용들을 가지는 도구띠 를 
만드는데 쓰인다. Category 복합칸을 누르고 작업하려고 하는 작용들의 모임을 선택한다. 
Actions 목록칸은 현재 범주에 쓸수 있는 작용들을 표시한다. Toolbar 목록칸은 창조하 
려는 도구띠단추들을 표시한다. 푸른색의 왼쪽과 오른쪽 화살표를 선택하여 작용들을 
Toolbar 목록칸의 안이나 밖으로 이동한다. 푸른색의 올리 및 내리화살표를 눌러서 
Toolbar 목록칸의 우나 아래로 작용들을 이동한다. Ac 仕 ons 목록칸의 〈 Separator 〉 는 보 
통 필요할 때 Toolbar 목록칸으로 이동될수 있으며 완료된 도구띠에 분리선이 나타나게 
한다. 

Choose available menus and toolbars 위자드페지로 돌아오려면 Back 를 찰칵한 
다. Finish 를 선택하여 기본창문을 구성하고 위자드를 완료한다. 위자드의 임의의 폐지 
에서 Cancel 을 찰칵하여 변경없이 위자드를 닫는다. 

2. Data Table 위자드 

Data Table 위자드는 자료표창문부품을 선택하고 그것을 폼에 배치하면 자동적으로 
기 동한다. 자료표창문부품은 자료기 지 자료의 표보기 를 창조하는데 러 용된 다. 

1) 자료기지와 표의 선택 (Choose the Database and Table ) 
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그림 1-144. Choose the Database and Table 위 자드페 지 
Choose the Database and Table 위자드페지가 처음으로 나타난다. 유효한 자료기지 
들이 Database Connec 仕 on 목록칸에 표시된다. 그것을 눌러서 련결을 선택한다. 목록칸에 
렬거된 련결이 없으면 Setup Database Connections 를 선택하여 Edit Database 
Connec 社 ons 대화칸을 펼친다. Table 목록칸에는 선택된 자료기지련결에서 유효한 표와 보 
기들을 모두 표시한다. 그것을 눌러서 표나 보기를 선택한다. 

Next 를 눌러서 다음의 위자드페지로 이동한다. 

2) 현시된 마당 (Displayed Fields ) 



그림 1-145. Displayed Fields 위 자드폐지 
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Displayed Fields 위 자드페 지 는 표에 표시 될 마당들을 선택 하는데 리 용된다. 기정 으 
로 표나 보기의 주열쇠를 제외한 매개 마당은 처음에 Displayed Fields 목록에 배 치된다. 
푸른색의 왼쪽 및 오른쪽 화살단추를 찰칵하여 마당들을 Available Fields 목록칸으로부 
터 Displayed Fields 목록칸의 안이 나 밖으로 이동한다. 푸른색의 우 및 아래화살단추들 
을 눌러서 Displayed Fields 목록칸안의 우아래로 마당들을 이동한다. 마당들이 
Displayed Fields 목록칸에 나타나는 순서 는 그것들이 Data Table 에서 제 일 왼쪽란의 제 
일 꼭대기 마당에서부터 표시되는 순서 이 다. 

Next 를 찰칵하여 다음의 위 자드페 지 로 이 동한다. Choose the Database and Table 
위자드페지로 돌아가려면 Back 를 찰칵한다. 

3) 표속성 (Table Properties ) 



그림 1-146. Table Properties 위자드페지 

Table Properties 위자드폐지는 Data Table 의 초기 편집 선택들을 설정 하는데 쓰인 
다. Read-Only 검사칸을 설정 하여 레코드의 편집과 삭제, 추가를 방지 한다. 
Confirmations 절의 검사칸들을 설정하여 사용자가 변경을 확인하게 한다. 기정으로 사 
용자들은 삭제를 확인해야 한다. Allow column sorting 을 눌러서 사용자가 렬머러부 
(마당이름을 표시한다)를 선택하여 자료를 정렬하게 한다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. Displayed Fields 위자드폐지로 
돌아가려면 Back 를 찰칵한다. 

4) SQL 
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그림 1-147. SQL 위자드폐지 

SQL 위자드페지는 려과기들을 적용하여 표안의 자료를 정렬한다. Filter 행편집칸을 
선택 하고 WHERE 열쇠단어없 이 유효 SQL WHERE 절을 입 력 한다. 려 과기 는 표에 표시 되 
는 자료에 적용한다. 

표안의 유효마당들을 정렬하려면 푸른색의 왼쪽 및 오른쪽 화살단추들을 선택하여 
Available Fields 목록칸으로부터 Sort By 목록칸의 안이나 밖으로 마당들을 이동한다. 
푸른색의 올리 및 내리화살단추들을 선택하여 Sort By 목록칸안에서 우아래로 마당들을 
이동한다. A-Z 단추들을 선택하여 Sort By 목록칸의 선택된 마당들의 정 렬순서를 커지는 
순서로，혹은 작아지는 순서로 변경한다. 

Next 를 찰칵하여 다음의 위자드페 지로 이동한다. Table Properties 위자드폐지로 
돌아오려면 Back 를 찰칵한다. 

5) 완료 ( Finish ) 
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그림 1-148. Finish 위자드폐지 

Finish 위자드페지는 자동편집기능을 선택하고 위자드를 완료하는데 쓰인다. 사용자 
가 다른 레코드로 항행할 때 사용자편집 례를 들면 삽입과 갱신이 자동적으로 적용되게 
하려면 AutoEdi 出 ng 검사칸을 설정한다. AutoEditing 이 해제되면 사용자들은 Enter 을 
눌러서 다른 레코드로 이동하기전에 자기 편집을 확인해야 하며 그렇지 않으면 자기가 
편집한 내용을 잃는다. 

Finish 를 선택하여 위자드에서 선택한 기능들을 모두 가진 자료기지창문부품을 창 
조한다. SQL 위 자드페 지 로 돌아가려 면 Back 를 찰칵한다. 변경없 이 위 자드를 완료하려 면 
임의의 위자드페지에서 Cancel 을 찰칵한다. 

3. Data Browser 위자드 

Data Browser 위 자드는 DataBrowser 창문부품을 선택 하고 그것 을 폼우에 배 치 함으 
로써 자동적으로 호출된다. DataBrowser 창문부품은 자료기지 자료의 좀보기를 창조하는 
데 리용된다. 

1) 자료기 지 와 표의 선택 (Choose the Database and Table) 
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그림 1-149. Choose the Database and Table 위 자드폐지 
Choose the Database and Table 위 자드페 지 가 처 음에 나타난다. 유효한 자료기지 
들이 Database Connection 목록칸에 표시된다. 련결을 눌러서 선택한다. 목록칸에 어 
떤 련결도 표시 되 여있지 않으면 Setup Database Connections 을 눌러서 Edit 
Database Connections 대화칸을 연다. Table 목록칸은 선택된 자료기지 련결에서 유효한 
모든 표와 보기들을 표시 한다. 표나 보기를 하나 눌러서 선택 한다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. 

2) 현시된 마당들 (Displayed Fields ) 



그림 1-150. Displayed Fields 위 자드폐지 
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Displayed Fields 위 자드페 지 는 표에 표시 하려 는 마당들을 선택 하는데 사용된 다. 푸 
른색의 왼쪽 및 오른쪽 화살단추들을 눌러서 Available Fields 목록칸으로부터 
Displayed Fields 목록칸의 안이 나 밖으로 마당들을 이동한다. 푸른색 의 올리 및 내 리 화 
살단추들을 눌러서 Displayed Fields 목록칸안에서 우아래 로 마당들을 이동한다. 

Next 를 찰칵하여 다음의 위 자드페 지 로 이 동한다. Choose the Database and Table 
위자드페지로 돌아가려면 Back 를 찰칵한다. 

3) 항행 과 편집 (Navigation and Editing ) 



그림 1-151. Navigation and Editing 위 자드폐지 
Navigation and Editing 위 자드페 지 는 항행 과 편집 단추들을 창조하는데 리 용된다. 
Include Navigation Buttons 검 사칸을 설정 하여 항행 단추들을 포함한다. 
Naviga 社 on 절에서 Previous 를 선택하여 폼우에 Previous 단추를 표시한다. 이 선택은 
표안의 이전의 레코드로 항행 하게 한다. Next 를 찰칵하여 폼우에 next 단추를 표시한다. 
이 단추는 표안의 다음의 레코드로 항행하게 한다. First 를 선택하여 폼우에 First 단추를 
표시한다. 이 선택은 표안의 첫 레코드로 항행하게 한다. Last 를 선택하여 종우에 Last 
단추를 표시한다. 이 단추는 표안의 마지막 레코드로 항행하게 한다. 

Include Edit Buttons 검 사칸을 설정 하여 편집단추들을 포함한다. Editing 절 에서 
Insert 검사칸을 설정하여 새 레코드를 추가하기 위한 Insert 단추를 창조한다. Update 검 
사칸을 설정하여 현존 레코드들을 갱신하기 위한 Update 단추를 창조한다. Delete 검사 
칸을 설정하여 레코드들을 삭제하기 위한 Delete 단추를 창조한다. 

항행단추들과 Update 및 Delete 단추는 코드를 추가하지 않아도 동작한다. 대 부분 
의 자료기지들은 유일건을 가지는 새 레코드창조기능이 없이 설계되므로 Insert 단추는 
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동작하지 않는다. 이것은 QDataBrowser :: beforeInsert () 신호에 련결된 처리부를 만들 
어 간단히 해결할수 있다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. Displayed Fields 위자드폐지로 
돌아가려면 Back 를 찰칵한다. 

4) SQL 


그림 1-152. SQL 위자드폐지 

SQL 위자드페지는 려과기들을 적용하여 표안의 자료를 정렬한다. Filter 행편집칸을 
선택 하고 WHERE 열쇠단어없 이 유효 SQL WHERE 절을 입 력한다. 려과기 는 표에 표시 되 
는 자료에 적용한다. 

표안의 유효마당들을 정렬하려면 푸른색 왼쪽 및 오른쪽 화살단추들을 선택하여 
Available Fields 목록칸으로부터 Sort By 목록칸의 안이나 밖으로 마당들을 이동한다. 
푸른색 올리 및 내 리화살단추들을 선택하여 Sort By 목록칸안에서 우아래로 마당들을 이 
동한다. A - Z 단추들을 선택하여 SortBy 목록칸의 선택된 마당들의 정렬순서를 커지는 순 
서로，혹은 작아지는 순서로 변경한다. 

Next 를 찰칵하여 다음의 위자드페지 로 이동한다. Navigation and Editing 위자드 
폐지로 돌아가려면 Back 를 찰칵한다. 

5) 배 치 ( Layout ) 
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그림 1-153. Layout 위자드폐지 

Layout 위자드폐지는 자료기지열람기의 배치를 설계하는데 리용된다. 폼이 사용할 
렬수를 선택하려면 Number of Columns 스핀칸을 선택한다. 자료항목마당들의 왼쪽에 
표식 자들이 나타나게 하려 면 Labels to left 라지 오단추를 찰칵한다. 자료항목마당들의 
우에 표식자들이 나타나게 하려면 Labels on top 라지오단추를 찰칵한다. 

Create layout for fields 검 사칸을 선택 하여 칸배 치 안쪽의 모든 창문부품들을 배 렬 
한다. Create layout for buttons 검 사칸을 설정 하여 칸배 치 안쪽의 모든 단추들을 배 렬 
한다. Create layout for all 를 선택하여 전체 창문부품을 위한 칸배 치를 창조한다. 

항상 배 치를 해체하고 그것들을 후에 재시행할수 있다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. SQL 위자드페지로 돌아가려면 
Back 를 찰칵한다. 

6) 완료 ( Finish ) 
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그림 1-154. Finish 위자드폐지 

Finish 위자드페지는 자동편집기능을 선택하고 위자드를 완료하는데 쓰인다. 사용자 
가 다른 레코드로 항행할 때 사용자편집 례를 들면 삽입과 갱신이 자동적으로 적용되게 
하려면 AutoEdi 出 ng 검사칸을 설정한다. AutoEditing 이 해제되면 사용자들은 Enter 을 
눌러서 다른 레코드로 이동하기전에 자기 편집을 확인해야 하며 그렇지 않으면 자기가 
편집한 내용을 잃는다. 이 속성은 후에 필요할 때 변경할수 있다. 

Finish 를 선택하여 위자드에서 선택한 기능들을 모두 가진 자료기지창문부품을 창 
조한다. Layout 위자드페지로 돌아가려면 Back 를 찰칵한다. 임의의 위자드페지에서 
Cancel 을 찰칵하여 변경없 이 위 자드를 완료할수 있 다. 

4. Data View 위자드 

Data View 위자드는 자료보기창문부품을 선택하고 종우에 그것을 배 치하여 자동적 
으로 호출될 수 있 다. Dataview 창문부품은 자료기 지 자료의 읽 기 전용폼보기 를 창조하는데 
쓰인다. 

1) 자료기 지 와 표의 선택 (Choose the Database and Table ) 
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그림 1-155. Choose the Database and Table 위 자드폐지 
Choose the Database and Table 위 자드페 지 가 처 음으로 나타난다. 유효한 자료기 
지들이 Database Connection 목록칸에 표시된다. 그것을 눌러서 련결을 선택한다. 목 
록칸에 렬거된 련결이 없으면 Setup Database Connections 를 선택하여 Edit 
Database Connections 대화칸을 펼친다. Table 목록칸에는 선택된 자료기지련결에서 유 
효한 표와 보기들을 모두 표시한다. 그것을 눌러서 표나 보기를 선택한다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. 

2) 현시된 마당 (Displayed Fields ) 



그림 1-156. Displayed Fields 위 자드폐지 
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Displayed Fields 위 자드페 지 는 표에 표시 될 마당들을 선택 하는데 리 용된 다. 푸른색 
의 왼쪽 및 오른쪽 화살단추를 찰칵하여 마당들을 Available Fields 목록칸으로부터 
Displayed Fields 목록칸의 안이 나 밖으로 이동한다. 푸른색의 우 및 아래화살단추들을 
눌러서 Displayed Fields 목록칸안의 우아래 로 마당들을 이동한다. 

Next 를 찰칵하여 다음의 위 자드페 지 로 이 동한다. Choose the Database and Table 
위자드페지로 돌아가려면 Back 를 찰칵한다. 

3) 배 치 ( Layout ) 



그림 1-157. Layout 위자드폐지 

Layout 위자드폐지는 자료기지보기의 배치를 설계하는데 리용된다. 폼이 사용할 렬 
수를 선택 하려면 Number of Columns 스핀칸을 선택 한다. 자료항목마당들의 왼쪽에 표 
식자들이 나타나게 하려면 Labels to left 라지오단추를 찰칵한다. 자료항목마당들의 우 
에 표식자들이 나타나게 하려면 Labels on top 라지오단추를 찰칵한다. 

Next 를 찰칵하여 다음의 위자드페지로 이동한다. Displayed Fields 위자드폐지로 
돌아가려면 Back 를 찰칵한다. 

4) 완료 ( Finish ) 
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그림 1-158. Finish 위자드폐지 

Finish 위자드페지는 이전의 위자드페지들에서 요구하는 선택들을 모두 설정한 다음 
에 위자드를 창조하는데 쓰인다. 

Finish 를 찰칵하여 위자드에서 선택한 기능을 모두 가지는 자료열람기창문부품을 
창조한다. Layout 위자드페지로 돌아가려면 Back 를 찰칵한다. 임의의 위자드페지에서 
Cancel 을 찰칵하여 변경을 보관하지 않고 위 자드를 완료한다. 

제14절. 창문 

Qt Designer 는 기동할 때 왼쪽에 3개의 창문을 펼친다. 이것들은 Project 
Overview 창문, Object Explorer 창문，그리고 Property Editor/Signal Handlers 창 
문이다. 또한 Qt Designer 는 폼의 차림표용작용들과 차림표항목들을 창조하기 위한 
Action Editor 를 제공한다. 이 절에서는 매개창문들에 대하여 자세히 설명한다. 

1. Project Overview 창문 

이 창문은 프로젝트와 련관된 파일들을 모두 렬거한다. Files 목록에서 폼이나 파일 
을 한번 눌러서 그것을 펼친다. 픔과 파일들사이를 고속으로 절환하기 위하여 파일목록 
우의 행 편집 칸에 파일 이 름을 입 력 하면 Qt Designer 는 증분탐색 을 수행 하여 일 치 하는 파 
일들이 나 폼들을 표시한다. 
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그림 1-159. Project Overview 창문 

파일(혹은 프로젝트)를 오른쪽 단추로 눌러서 선택 용문맥 차림 표 실례 로 Open form 
이나 Remove form from project 를 얻는다. 

2. Object Explorer 창문 

Object Explorer 창문은 현재 폼의 창문부품과 처리부들을 렬거한다. 창문에는 두 
개의 타브 즉 Objects 타브와 Members 타브가 있다. 



그림 1-160. Objects 타브 
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1) Objects 타브 

Widgets 타브를 선택하여 현재 종의 창문부품들을 모두 표시한다. 창문부품들은 
이름과 클라스별로 렬거된다. 목록안의 창문부품을 선택하여 대응하는 종안에서 그것을 
강조표시 한다. 



그림 1-161. Members 타브 


2) Members 타브 

Members 타브를 선택하면 현재 폼의 처리부들，앞방향선언들, 머리부들, 그리고 
클라스변수들을 표시한다. Members 타브는 나무보기를 사용하여 그 정보를 현시하다. + 
부호를 가지는 항목들은 +를 누르면 펼처지는 보조항목들을 가지고있다. 나무보기의 항 
목을 오른쪽 단추로 눌러서 문맥차림표를 펼친다. 

처리부를 편집 혹은 추가하려면 Slots 폴더를 오른쪽 단추로 찰칵하고 Edit 를 선택 
하여 Edit Slots 대화칸을 연다. Public , Protected 혹은 Private 보조등록부들을 오른 
쪽 단추로 찰칵하고 New 를 선택하여 Edit Slots 대화칸을 펼친다. 목록안의 처리부를 
오른쪽 단추로 눌러서 그 처 리부용의 추가적 인 선택 이 있는 차림표를 펼친다. 새 처 리부 
들을 추가하려면 차림표에서 New 를 선택하여 Edit Slots 대화칸을 펼친다. 선택된 처 리 
부의 속성들을 변경 하려면 Properties 를 선택 하여 Edit Slots 대화칸을 연다. C ++ 편집기 
를 열고 선택된 처리부의 실현으로 이행하려면 Goto Implementation 을 선택한다. 선택 
된 처리부를 삭제하려면 Delete 를 누른다. 신호를 처리부와 갈은 방법으로 추가하거나 
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삭제할수 있다. 

Forward Declarations 와 Includes (in declaration ), Class Variables , 
Includes (in implementation ) 를 오른쪽 단추로 눌러서 new 혹은 edit 선택을 가지는 
문맥차림표를 펼친다. New 를 선택하여 선언, 변수 혹은 머리부를 입력하기 위한 행편 
집칸을 펼친다. Forward Declarations 를 오른쪽 단추로 찰칵하고 Edit 를 선택하여 
Edit Forward Declarations 대 화칸을 연다. Includes (in declaration ) 를 오른쪽 단추 
로 찰칵하고 Edit 를 선택하여 Edit Includes (in Declaration ) 대화칸을 연다. Class 
variables 를 오른쪽 단추로 찰칵하고 Edit 를 선택하여 Edit Class Variables 대화칸을 
연다. Includes (in Implementation ) 를 오른쪽 단추로 찰칵하고 Edit 를 선택 하여 Edit 
Includes (in Implementation ) 대화칸을 연다. 


3. Property Editor/Signal Handlers 창문 

Property Editor/Signal Handlers 창문을 선택 하여 픔과 창문부품，차림 표들의 속 
성을 표시하고 변경 한다. 이 창문에는 Properties 타브와 Signal Handlers 타브가 있다. 

B ■■■■田 

Properties I Signal Handlers | 



그림 1-1 的. Properties 타브 
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1) Properties 타브 

Properties 타브를 선택하여 선택된 창문부품의 외관과 동작을 변경한다. (차림표인 
경우에는 차림표띠를 선택하여 Property Editor 에 차림표항목의 속성들을 표시한다.) 
Property Editor 에 는 두개 의 렬 즉 속성이 름들을 렬 거 하는 Property 렬 과 값들을 렬 
거하는 Value 렬이 있다. 렬의 머리부를 를 선택하여 속성 이나 값들을 정렬한다. 일부 
속성이름들은 왼쪽의 정 방형안에 +기 호를 가지고있다. 이것은 속성이름이 련관된 속성들 
의 모임에 대한 집합이름이 라는것을 의미한다. 

일부 속성들은 단일값을 가진다. 실례로 이름속성은 본문값을 가지고 폭속성(실례 
에서 mininrumSize ) 은 수값을 가진다. 본문값을 변경하려면 현존 본문을 선택하고 새 
본문을 입력한다. 수값을 변경하려면 그 값을 선택하고 새로운 수를 입력하거나 스핀단 
추를 누르고 현존 수값이 요구하는 값에 이를 때까지 증가 혹은 감소시킨다. 일부 속성 
들은 고정된 값목록을 가진다. 실례로 mouseTracking 속성은 론리형으로서 True 혹은 
False 값을 가질수 있다. 유표속성도 역시 고정된 값목록을 가진다. 유표속성이나 
mouseTracking 속성을 선택 하면 그 값이 내리펼침복합칸에 나타나는데 아래 방향화살표 
를 눌러서 유효한 값들을 알아볼수 있다. 

일부 속성은 값들의 복잡한 모임을 가진다. 실례로 서체속성이 있다. 서체속성을 
선택하면 생략단추 (...) 가 나타나는데 이 단추를 찰칵하면 Select Font 대화칸이 펼쳐 
지 고 여 기서 서체설정 을 변경할수 있다. 다른 속성들도 그 속성 이 가지는 설정 에 따라서 
서로 다른 대화칸을 펼치는 생략단추들을 가지고있다. 실례로 text 속성에 입력할 본문이 
많다면 생 략단추를 찰칵하여 여 러행 본문편집대화칸을 펼친다. 변경되는 속성들의 이름은 
강조체로 표시된다. 속성을 변경하였는데 그 기정값으로 되돌려보내 려고 하지 않으면 그 
속성값을 선택하고 값의 오른쪽에 있는 붉은색의 X 단추를 찰칵한다. 일부 속성들은 초 
기값 실례로 TextEditl 을 가지지만 기정값은 없다. 초기값을 가지지만 기정값이 없는 
속성을 되살리면(붉은색의 X 단추를 찰칵하여) 그 값은 속성 실례로 이름이 비는것을 허 
용하지 않으면 비게 된다. 

속성편집기는 Undo 와 Redo 를 완전히 지원한다. ( Ctrl + Z 와 Ctrl + Y 를 Edit 차림표 
로부터 사용할수 있다.). 



그림 1-163. Signal Handlers 타브 
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2) Signal Handlers 타브 

Signal Handlers 타브를 선택하여 창문부품들의 신호들사이의 련결과 픔의 전용처 
리부들을 표시하거나 창조한다. 

4. Action Editor 창문 

Action Editor 창문은 사용자대 면부를 통하여 사용자가 초기 화하는 작용들을 창조하 
는데 쓰인다. 실례로 파일의 보관이나 인쇄. Action Editor 창문을 호출하려면 기본창문 
이 능동일 때 Window | Views | Action Editor 를 선택 한다. 



그림 1-164. Action Editor 

Action Editor 는 그 차림표띠에 3가지 기능 즉 창조，삭제 및 련결기능을 가지고 
있다. 또한 현존작용들을 렬거하는 목록보기를 가지고있다. 

새 로운 작용을 창조하려 면 차림 표띠 에서 Create a New Action 그림 기 호우의 화살 
표를 선택한다. 새로운 작용, 새로운 작용그룹, 또는 새로운 내리펼침작용그롭을 선택하 
여 창조한다. 또한 Action Editor 목록보기에서 현존 작용을 오른쪽 단추로 찰칵하고 튀 
여 나오기차림 표에 서 창조하려 는 작용형 을 선택 하여 작용들을 창조할수 있 다. 

목록보기에서 작용을 삭제하려면 목록에서 삭제하려는 작용을 선택하고 차림표띠에 
서 Delete Current Action 를 선택 한다. 또한 Action Editor 목록보기 에서 현존 작용을 
오른쪽 단추로 찰칵하고 튀여나오기차림표로부터 Delete Action 을 선택하여 작용들을 
삭제할수 있다. 
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작용을 처리부와 련결하려면 목록보기우에서 작용을 선택하고 차림표띠에서 
Connect 그림기호를 눌러서 View and Edit Connections 대화칸을 펼친다. 또한 
Action Editor 목록보기에서 현존작용을 오른쪽 단추로 선택하고 튀여나오기차림표의 
Connect Action 을 누름으로써 작용을 처 리부와 련결할수 있다. 

제15절. . ui 파일형식 

Qt Designer . ui 파일에 픔을 보관한다. 이 파일들은 XML 형식으로 폼요소들과 그 
특성 을 표시한다. 여 기서 는 XML 형 식 에 대 한 개 괄을 주며 개 발자들이 자체 로 . ui 구문해 
석기를 쓰는데 충분한 정 보를 제공하여 . ui 파일들을 프로그람적으로 읽고 수정할수 있게 
하려고 한다. 

. ui 파일의 문법을 해석하는 한가지 방법은 Qt 의 QDomDocument 클라스를 사용하 
는것이다. 이것은 Qt Designer 가 이 클라스를 사용하는 방법이다. 원천파일 
uilib / qwidgetfactory . h 과 uilib / qwidgetfactory . cpp 을 참고하시오. 

. ui 파일의 문서형은 간단히 UI 이므로 doctype 꼬리표는 다음과 같다. 

<!DOCTYPE UI 〉 

뿌리요소는 UI 로서 전체 내용을 둘러싼다. 

<UI version :’’3. 1’’ stdsetdef =,, l M > 

</ UI > 

UI 항목안에서 다음과 같은 요소형의 하나이거나 없을수 있다. 

actions - QMainWindow 픔용작용들 

author - 픔의 저자 

class - 폼의 클라스이름 

comment - 설명 실례로 저작권표기 

connections - 신호-처리부련결 

customwidgets - 사용자정의창문부품(낡은 형식) 

exportmacro - Windows 에 고유 

forwards - 앞방향선언 

functions - 함수선언 

images 一 매몰된 화상: 매몰된 화상들을 포함하는 . ui 파일들에 대해서만. 화상들은 
보통 개별적인 images 등록부에 보관된다. 
includes - 머 리부파일 
layoutdefaults - 배 치 속성 의 기 정 값 
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layoutfunctions - 배 치 속성 의 동적 기 정 값 
menubar - QMainWindow 폼들의 차림표띠 

pixmapfunction - 매몰형픽스매프나 외부 픽스매 프들이 사용되지 않으면 픽스매 프 
들을 엄는데 사용하는 함수이름 

pixmapinproject - 픽 스매프 가 .pro 파일에 의하여 조종된다는것을 가리키는 요소 

signals - 신호선언 

slots - 처리부선언 

tabstops - 픔의 타브순서 

toolbars - QMainWindow 픔의 도구띠 

variables - 클라스변수 

widget 一 픔자체. 이 요소는 다른 창문부품요소들을 비롯한 다른 요소들을 포함할수 있다. 
forward - Qt 3 .x 베 타이전과 호환 
include - Qt 2 .x 이전과 호환 
variable - Qt 3 .x 베 타이전과 호환 

요소들의 순서화는 자유이 고 일반적으로 class 요소가 우선이 다. 

1. UI 요소 

1) actions 

이 요소는 폼의 작용들을 보관하는데 쓰인다. 이것은 QMainWindow 폼들에서만 
발생 한다. 

actions 요소는 하나이상의 action 요소들을 포함한다. 매개 action 요소는 하나이상의 속성들 
을 포함한다. 매개 속성은 name 속성과 datatype 요소안에 포함되는 단일값을 포함한다. 
<actions> 

<action> 

〈property name="name’’> 

<cstring>fileNewAction</cstring> 

々 property 〉 

<property name="iconSet"> 

<iconset>filenew</iconset> 

々 property 〉 

〈property name=’’text"> 

<string>New</string> 

々 property 〉 

〈property name=’’menuText"> 

<string>&amp;New</string> 
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〈property name=’’accel ’’〉 
<number>4194382</number> 
</property> 

</action> 


</actions> 

2) author 

이 요소는 저자이름을 단순문자렬로 보관하는데 쓰인다. 

<author>B amey Rubble</author> 

3) class 

이 요소는 폼의 클라스이름을 단순문자렬로 보관하는데 쓰인다. 

<class>InsuranceFonn</class> 

4) comment 

이 요소는 주석 실례로 저작권을 단순문자렬로 보관하는데 쓰인다. 

<comment> 

************************************************************** 

** Copyright (C) 2002 Trolltech AS. All rights reserved. 

** This file is part of Qt Designer. 

** This file may be distributed and/or modified under the terms of the 
** GNU GPL version 2 as published by the Free Software 
** Foundation and appearing in the file LICENSE.GPL included in the 
** packaging of this file. 

** This file is provided as is with no warranty of any kind,including the 
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A 
** PARTICULAR PURPOSE. 

** See http://www.trolltech.com/gpl/ for GPL licensing information. 

** Contact info@trolltech.com if any conditions of this licensing are 
** not clear to you. 

</comment> 

5) connections 

이 요소는 픔에서 신호-처리부련결을 기록하는데 쓰인다. 

connections 요소는 하나이상의 connection 요소와 하나이상의 slot 요소를 포함한다. 매 
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개 connection 요소는 신호하는 객체와 그 신호 그리고 수신하는 객체와 그 처리부를 식별 
한다. 

〈 connections 〉 


〈connection language=’’C++"> 

<sender>alignActionGroup</sender> 

<signal>selected(QAction*)</signal> 

<receiver>EditorForm</receiver> 

<slot>changeAlignment(QAction*)</slot> 

</connection> 


々 connections 〉 

6) custom widgets 

Qt Designer 는 사용자정의창문부품을 만들수 있다. 사용자정의창문부품은 . ui 파일 
에 서 <customwidget> 요소에 의 하여 표시 된 다. 

이 것들은 폼우에 재색직 4 각형 으로 표시 되는 낡은 형 식의 사용자정 의창문부품들이다. 
플라그인들을 사용하여 자기의 사용자정의 창문부품들을 Qt Designer 에 원만히 통합할수 
있다 (6 절 2. 참고). 

매 개 사용자정 의창문부품은 클라스이 름과 머 리부파일 을 가전 다. 또한 크기암시 와 
크기정 책 을 가전다. 픽스매 프가 지정 될수 있으며 이것은 사용자가 사용자정의 창문부품의 
실례를 창조하는데 사용할수 있는 Qt Designer 도구띠 단추에 표시된다. 사용자정의창문 
부품들은 보통 신호를 발생하는데 이것들이 렬거된다. 창문부품이 가지는 속성의 이름과 
형이 역시 포함된다. 


<customwidgets> 



<class>StyledButton</class> 

〈header location="local’’ 〉 styledbutton.h</header 〉 
<sizehint> 

<width>40</width> 

<height>25</height> 

</sizehint> 

<container>0</container> 



<hordata>5</hordata> 
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<verdata>5</verdata> 

</sizepolicy> 

<pixmap>imageO</pixmap> 

<signal>clicked()</signal> 

<signal>changed()</signal> 

〈property type="Color">color</property> 

〈property type =,, Pixmap M >pixmap</property> 

〈property type="Boor'>scale</property> 

</customwidget> 

</customwidgets> 

7) exportmacro 

이 꼬리 표는 Windows 사용자와만 관련되 여있 다. 

Windows 에 고유한 반출마크로를 요구하는 클라스(실례로 DLL 에서 class 
win_specific_declaration_goes_here 와 같이 선언해야 할 클라스)가 있다면 <exportmacro>^- 
리표를 리용할수 있다. (표준 Qt 에서는 Q_EXPORT 마크로를 사용한다. 실례로 class 
Q_EXPORT QWidget.) 이 꼬리 표를 사용한다면 또한 다음과 같이 해 야 한다. 

마크로정의를 포함하는 파일을 포함해 야 한다. 

폼에 반출마크로를 추가한다 . 이것은 픔의 이름속성의 export macro 보조등록부에 
서 마크로의 이름을 입력하여 달성된다. 

다음것 은 이 걸 음들에 의 하여 Uic 가 정 확한 class YOUR_MACRO Form 선 언들을 창조 
한다는것을 담보한다. 

<exportmacro>EDITOR_EXPORT</exportmacro> 

8) forwards 

앞방향선언이 필요한 경우가 있다. 특히 Qt Designer 에 의하여 . ui.h 파일들에 코드 
를 쓰고있다면 더하다. 매개의 앞방향선언은 생성된 C ++ 코드에서 나타나야 하는것처럼 
렬거된다. 

<forwards> 

<forward>class QStringList;</forward> 

</forwards> 

9) functions 

functions 요소는 함수목록을 포함한다. 이것은 표준 C++ 함수이 다. 함수기 호를 창조하 
기 위하여 각종 속성들을 지정할수 있다. 실례로 

access : private, protected 혹은 public 를 들수 있다. 기정은 public 이다. 
returnType ： 함수의 돌림값 자료형. 기정은 void 


243 





specifier ： non virtual , virtual 혹은 pure virtual 이다. 기정은 virtual 이다. 
language ： 프로그람언어를 지정한다. 기정은 C ++ 이다. 

<functions> 

<function access=’’private” specifier="non virtual n >isValid()</function> 

<flmction access="public” retumType= ,, QString M >getMessage()</function> 

〈 /functions 〉 

10) images 

화상은 보통 자체의 파일들에 보관되고 프로젝트파일에 의하여 폼과 련관된다. 이 
것은 화상들을 하나의 프로젝트에서 그리고 프로젝트들사이에서 임의의 개수의 폼들을 
서로 엇바꾸어 공유할수 있다는 우점을 가전다. 

일부 경우에 픔안에 직접 화상자료를 보관할것을 요구할수 있으며 <image> 꼬리표가 
이것을 허용한다. 

PNG 와 XPM 형식으로 화상들을 보관할수 있다. 실천에서는 일부 PNG 서고들의 오 
유로 인하여 XPM 만 권고된다. 화상자료를 부호화하는 방법을 알려면 resource.cpp 안의 
savelmageData 함수를 참고하시오. 

〈 images 〉 

〈image name="imageO"> 

<data format= n XPM.GZ M length= M 409 M >789cd3d7528808fD55d0d2e72a2e492cc94c5648c 
e482c52d04a29cdcdad8c8eb5ade6523234530022630543251d2e253d856405bffcbc54105bl9c85636 
0003103711c6b53006ab440370316528264b4cl98450c5808a94dled00aac214832b43124b544ec414 
d34b4c4c441103fll341120831309758313d0cf3b0840b7258d55a73010092cl4eca</data> 

</image> 

</images> 

11) includes 

흔히 . ui 파일 에 머 리부파일들을 포함할 필요가 있 다. 머 리부파일들은 국부적(즉 프 
로젝트의 등록부에 관하여)이거 나 대역적(즉 Qt 혹은 를파일러표준서고들의 부분)일수 
있다. 머리부파일들은 될수록 실현에서 선언된다. 물론 선언(머리부)파일에서 그것들을 
선언할 필요가 있다. 

Qt Designer 는 자동적 으로 . ui 의 . ui.h 파일에 자동적 으로 〈 include 〉 꼬리표들을 추가 
한다. 

<includes> 

〈include location=’’local" impldecl="in implementation n >pixmapcollection.h</include> 
〈include location="local" impldecl="in implementation">pixmapchooser.h</include> 
〈include location="local" impldecl="in implementation n >project.h</include> 
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<include location="global’’ impldecl="in implementation">qfileinfo.h</include> 

<include location="global" impldecl= M in implementation n >qimage.h</include> 

〈include location="global" impldecl="in declaration">qpixmap.h</include> 

〈include location=”local’’ impldecl =, 'in implementetion’’ 〉 pixniapcollectioneditor.ui.h<yinclude> 
</includes> 

12) layoutdefaults 

매개의 폼은 기정공간과 여백크기를 가진다 . 이것들은 경우에 따라 바물수 있다 . 
〈layoutdefaults spacing=’’6" margin="ll"/> 

13) layoutfunctions 

흔히 공간과 여백값들은 동적으로 결정되여야 한다 . 그래야 례를 들면 창문관리기 
에서 일반적형식을 줄수 있다 . 

<layoutfunctions spacing=’’LayoutClass :: spacing” margin=’’LayoutClass :: margin "/〉 
margin 와 spacing 값들에 대 한 규칙들은 다음과 같다 . 

① margin 이나 spacing 에 대하여 옹근수값이 지정되면 그 값이 사용된다 . 

② 비옹근수값이 지정되고 배치함수가 지정되면 그 함수가 사용된다 . 

③ 비옹근수값이 나 함수가 지정되 면 layoutdefaults 로부터 기정값이 사용된다 . 

14) menubar 

QMainWindow 를 사용하는 응용프로그람들은 흔히 차림표띠를 가전다 . 차림표띠 
는 이 름속성 과 하나이상의 튀 여나오기차림 표항목을 가전 다 . 매 개 차림 표항목은 하나이 상 
의 작용들과 분리선을 가진다 . 

<menubar> 

〈property name="name ’’〉 

<cstring>menubar</cstring> 

</property> 

<item text="&amp;File M name="PopupMenu"> 

〈action name=’’fileSaveAction"/> 

<separator/> 

<action name= M fileExitAction n /> 

</item> 

<item text="&amp;Help" name="PopupMenu_2 n > 

<action name =,, helpAboutAction n /> 

<action name= n helpAboutQtAction M /> 

</item> 

</menubar> 
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15) pixmapfunction 

화상들은 보통 프로젝트파일들에서 자기의 파일이름들을 렬거하여 포함된다. 화상 
들은 또한 images 꼬리표에 의하여 직결로 포함될수 있다. 화상들을 취급하는 다른 방법 
은 함수이름을 지정하는것이다. 이 함수는 련관된 화상의 이름(혹은 열쇠)을 리용하여 
호출되며 적당한 화상의 적재에 응답할수 있다. 그러한 함수이름을 지정하려면 
<pixmapfiinction> 꼬리표가 사용된다. 

<pixmapfunction>splashScreen</pixmapfunction> 

16) pixmapinproject 

대 부분의 응용프로그람들은 자기 의 화상들을 응용프로그람의 프로젝 트파일 에 목록된 개 
별적파일들로 보관한다. 이것은 <pixmapinprojec 다꼬리표를 포함하여 표시될수 있다. 
<pixmapinproj ect/> 

17) signals 

모든 신호는 <signals> 꼬리표안에 렬거된다. 

<signals> 

<signal>somethingChanged()</signal> 

〈 /signals 〉 

18) slots 

slots 요소는 처리부목록을 포함한다. 매개의 slot 요소는 처리부의 원형을 준다. 
<slots> 

<slot access= n public" specifier= M virtual n language=’’C++" 
retumType="void">changeAlignment(QAction* align)</slot> 

</slots> 

19) tabstops 

타브중지 는 픔에 서 사용자타브로서 초점 을 얻 는 창문부품을 가리킨다. <tabstops 〉 꼬 
리표는 타브중지목록을 포함하며 매개 타브중지는 창문부품의 이름을 보관한다. 
<tabstops> 

<tabstop>templateView</tabstop> 

<tabstop>helpButton</tabstop> 

<tabstop>buttonOk</tabstop> 

<tabstop>buttonCancel</tabstop> 

</tabstops> 

20) toolbars 

도구띠(류동창문)를 가지는 품들은 <toolbars> 꼬리표에 의하여 그 세부를 보관한다. 
이 폼들은 보통 QMainWindow 들(혹은 파생클라스들)이 다. 매개 도구띠는 그 도구띠가 
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처음에 속하는 류동창문을 식별하는 류동속성을 가전다 . 그것들은 또한 이름과 표식자 
속성들을 가진다 . 매개 도구띠 단추는 작용에 의하여 표시된다 . 도구띠들은 또한 다른 창 
문부품들을 보유할수 있다 . 이 경우에 <toolbar > 꼬리표는 련관된 창문부품의 클라스와 이 
름，비 기정속성값들을 주는 적 당한 <widget > 꼬리 표들을 포함한다 . 

〈〔 toolbars 〉 

〈toolbar dock= ，， 2"> 

〈property name= n name"> 

<cstring>toolBar</cstring> 

々 property 〉 

<property name=’’label ’’〉 

<string>Tools</string> 

</property> 

<action name="fileNewAction n /> 

〈action name= n fileOpenAction n /> 

<action name= M fileSaveAction"/> 

<separator/> 

<action name= ,, editUndoAction ,, /> 

<action name= n editRedoAction n /> 

<action name= M editCutAction M /> 

<action name=’’editCopyAction"/> 

<action name="editPasteAction n /> 

</toolbar> 

〈toolbar dock="2’’> 

<property name=’’name’’> 

<cstring>Toolbar</cstring> 

</property> 

〈property name="laber> 

<string>T oolbar</string> 

</property> 

<action name="leftAlignAction"/> 

<action name= M centerAlignAction n /> 

<action name="rightAlignAction"/> 

<separator/> 

<action name="boldAction7> 
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〈action name="italicAction"/> 

<action name= n underlineAction n /> 

<separator/> 

<widget class=’’QComboBox’’> 

〈property name="name"> 

<cstring>fontComboBox</cstring> 

</property> 

</widget> 

<widget class="QSpinBox"> 

〈property name=’’name "〉 

<cstring>SpinBox2</cstring> 

</property> 

〈property name="minValue"> 

<number>6</number> 

</property> 

〈property name="value M > 

<number> 10</number> 

</property> 

</widget> 

々 toolbar 〉 

</toolbars> 

21) variables 

모듈변수들은 <variables> 꼬리표에 보관된다. 변수형이름들은 흔히〈와 >를 포함하 
며 실 체 로서 보관되 여 야 한다. 또한 호출형 즉 public, protected 혹은 private 를 지 정할수 
있 다. 기 정 은 protected 이 다. 

<variables> 

〈variable access= n private">SettingsDialog * settings;</variable> 

<variable>QMap&lt;int, QString&gt; bookmarks;</variable> 

<variable>HelpWindow *browser;</variable> 

<variable>HelpDialog *helpDock;</variable> 

<variable>QGuardedPtr&lt;FindDialog&gt; findDialog;</variable> 

<variable>static QPtrList&lt;MainWindow&gt; *windows;</variable> 

</variables> 
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22) widget 

창문부품들은 . ui 파일의 여 러 준위 에서 사용된다. 전체 폼자체 가 창문부품이고 
hboxes 와 vboxes , grids 와 같은 배치문맥내에서 다른 창문부품들을 포함한다. 

아래에 완성된 .ui 파일의 실례가 있다. 폼자체는 여러가지 비기정속성모임을 가진 
QWidget 이 다. 이 창문부품은 하나의 hbox 를 포함하며 이 수평 칸은 일부 비기정속성들 
을 가지며 하나의 QTextBrowser 창문부품을 포함한다. 

<!DOCTYPE UixUI version="3.1" stdsetdef=" 1 "> 

<class>WinIntroPage</class> 

<widget class= n QWidget"> 

〈property name="name ’’〉 

<cstring>WinIntroPage</cstring> 

</property> 

〈property name="geometry"> 

<rect> 

<x>0</x> 

<y>0</y> 

<width>3 87</width> 

<height>228</height> 

</rect> 

</property> 

〈property name="caption"> 

<string>Form 1 </string> 

〈 /property 〉 

<hbox> 

〈property name="name’’> 

<cstring>unnamed</cstring> 

々 property 〉 

〈property name="margin"> 

<number>l l</number> 

々 property 〉 

〈property name="spacing’’> 

<number>6</number> 

</property> 

<widget class= M QTextBrowser"> 
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〈property name="name n > 

<cstring>T extBrowser 1 </cstring> 

々 property 〉 

<property name="text"> 

<string>This program installs Qt.</string> 

</property> 

</widget> 

</hbox> 

</widget> 

<layoutdefaults spacing=’’6” margin="ll"/> 

</UI> 

23) forward 

이 꼬리표는 Qt 3.x 베 타이전과 호환되는것들에 포함되며 사용하지 말아야 한다 . 대 
신에 forwards 를 사용하시오 . 

24) include 

이 꼬리표는 Qt 2.x 베 타이전과 호환되는것들에 포함되며 사용하지 말아야 한다 . 대 
신에 includes 를 사용하시오 . 

25) variable 

이 꼬리표는 Qt 3.x 베 타이전과 호환되는것들에 포함되며 사용하지 말아야 한다 . 그 
대신에 variables 를 사용하시오 . 

2. 자료형요소 

bool - 론리값 (0 혹은 1), 실례로 <bool>l</bool> 

color - 색，실례로 <colorxred>192</red><green>0</greenxblue>255^1ue></color> 
cstring 一 C 문자렬값 (8-bit), 실례로 <cstring>Sometext</cstring> 
cursor - 유표형 을 가리키는 옹근수，실례 로 <cursor>4</cursor>. 유표형의 유효옹근수 
는 다음과 같다 . 

0 - ArrowCursor 

1 - UpArrowCursor 

2 - CrossCursor 

3 - WaitCursor 

4 - IbeamCursor 

5 - SizeVerCursor 

6 - SizeHorCursor 

7 - SizeBDiagCursor 
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8 - SizeFDiagCursor 

9 - SizeAllCursor 

10 - BlankCursor 

11 - SplitVCursor 

12 - SplitHCursor 

13 - PointingHandCursor 

14 - ForbiddenCursor 

enum - enum 이름，실례로 <enum>StrongFocus</enum> 
font - 서 체서술，실례 로 
<font> 

<family>Helvetica</family> 

<pointsize> 16</pointsize> 

<weight>50</weight> 

〈 italic 〉 1 〈 /italic 〉 

<underline>0</underline> 

<strikeout>0</strikeout> 

〈 /font 〉 

iconset - 그림 기 호모임 (픽 스매 프참고 ), 실 례 로 <iconset>filenew</iconset> 
number - 부호를 가질수 있는 옹근수，실례로 <number>947</number> 
palette - 조색 판 

pixmap - 픽스매프 , 보통 픽스매프의 이름 혹은 열쇠 ; 이름은 픽스매프들이 프로젝 
트에 보관되 면 사용되 고 열쇠 는 사용자정의함수가 픽스매 프호출에 사용되 는 경 우에 리용 
된다 . 또한 픽 스매 프들을 즉시 포함하는것 이 가능하다 . 실례 로 <pixmap>chair</pixmap> 
point - 점 , 실례로 <point><x> 1 5</x><y>95</y></point> 
rect - 직 4 각형 ， 실 례 로 
<rect> 

<x>20</x> 

<y>35</y> 

<width>225</width> 

<height>45</height> 

</rect> 

set - | 에 의 해 구분된 이 름목록，실 례 로 <set>AlignLeft|AlignTop</set> 
size - 크기，실례로 <size><width> 1 50</width><height> 1 05</height></size> 
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sizepolicy 一 크기형을 가리키는 옹근수，실례로 <hsizetype>5</hsizetype><vsizetype>4</ 
vsizetype>. 크기형의 유효옹근수들은 다음과 같다 . 

0 - Fixed 
1 - Minimum 

3 - MinimumExpanding 

4 - Maximum 

5 - Preferred 
7 - Expanding 

string - Unicode 문자렬값 (UTF8), 실례로 <string>Some text</string> 

복합자료형요소들 

palette 

이 원소는 매개 색그룹에 대하여 사용자대면부요소들을 위한 색을 보유한다 . 실례로 

<palette> 

<active> 


<color> 

... Foreground 

.. </color> 

<color> 

... Button ... 

</color> 

<color> 

... Light ... 

</color> 

<color> 

... Midlight 

. </color> 

<color> 

... Dark ... 

c/color 〉 

<color> 

... Mid .. 

</color> 

<color> 

... Text ... 

</color> 

<color> 

... BrightText .. 

</color> 

<color> 

... ButtonText . 

.. </color> 

<color> 

... Base ... 

</color> 

<color> 

... Background 

... c/color 〉 

<color> 

... Shadow .. 

. </color> 

<color> 

... Highlight .. 

. </color> 

<color> 

... HighlightText 

... </color> 


</active> 

<disabled> 

<color><red> 128</red><green> 128</green 〉 <blue> 128</blue></color> 


<color><red>255</red><green>255</green><blue>255^1ue></color> 

</disabled> 
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<inactive> 

<color><red>0</red><green>0</greenxblue>0</blue></color> 


<color><red>255</red><green>255</greenxblue>255^1ue></color> 

</inactive> 

</palette> 
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제 2 장. Qt 번역도구 


Qt 는 여러 언어로 응용프로그람을 번역하기 위한 우수한 기능을 제공한다 . 이 장에 
서 는 응용프로그람의 번역 과 관련된 Qt 번역 도구의 사용방법 을 설명한다 . 

제 1 절은 응용프로그람개 발책 임 자를 위한것 이 다 . 일반적 으로 이것은 쏘프트웨어 기사 
와 번역프로그람의 작업과 일치한다 . 여기서는 2 개 도구의 사용법을 서술한다 . lupdate 
도구는 원천코드와 번역을 동기시키기 위해 사용된다 . lrelease 도구는 출하되는 응용프 
로그람에 서 사용하는 실행시 번역 파일을 만드는데 사용된다 . 

제 2 절은 번역 프로그람용으로서 Qt Linguist 도구의 사용법 을 서 술한다 . 프로그람을 
시작하고 본문편집기 또는 문서처리기를 사용하는데는 어떤 를퓨터지식도 필요없다 . 

제 3 절은 Qt 프로그람작성 자를 위한것 으로서 번역 본문을 사용할수 있는 Qt 응용프로 
그람을 만드는 방법 을 설 명한다 . 그것 도 번역 프로그람이 구가 나타나는 문맥 을 확인하도 
록 방조하는 방법의 차림표를 제공한다 . 

1. 번역과정의 개관 

응용프로그람에서 번역되어야 하는 대부분의 본문은 단어나 짧은 구로 이루어져있 
다 . 이것들은 일반적으로 창문제목，차림표항목 , 튀여나오기방조본문 (balloon help) 과 
단추，검사칸 , 라지오단추에 대 한 표식 자로서 나타난다 . 

구는 단순하면서 특별한 문법을 사용하는 자국어로 프로그람작성자에 의해 원천코 
드에 입력된다 . 문법은 번역을 요구하는 구를 식별한다 . Qt 도구는 번역프로그람를 도와 
주기 위하여 매개 구에 대한 문맥정보를 제공한다 . 그리고 프로그람작성자는 필요하다면 
구에 문맥정보를 추가할수 있다 . 출하판관리기는 원천파일로부터 만들어지는 한조의 번 
역 파일 을 생 성하여 번역 프로그람에 게 넘 긴 다 . 번역 프로그람은 Qt Linguist 를 사용하여 
번역파일을 열고 번역을 입력하고 번역파일들에 결과를 내보내며 그것을 출하판관리기에 
넘긴다 . 출하판관리기는 그다음 응용프로그람에서 사용할 준비가 되여 있는 번역 파일들의 
고속이 고 조밀 한 판을 생 성한다 . 응용프로그람을 변경 하고 판갱 신하는 반복되 는 주기 에 
서 현존번역을 보존하고 새로운 번역이 요구된다는것을 쉽게 식별할수 있도록 도구를 설 
계한다 . Qt Linguist 도 여러개의 응용프로그람과 프로젝트들에 관하여 일관적인 번역 
을 정확히 하도록 돕기 위해 숙어집의 편리를 제공한다 . 

인간언어 의 미 묘성 과 복잡성때 문에 번역프로그람과 프로그람작성 자는 많은 문제 에 
대 답해 야 한다 . 

• 하나의 구는 문맥에 따라 여러가지 형태로 번역될수 있다 . 례를 들면 영어의 
open 은 도이월란드어로 offnen, "open file" 또는 aufbauen, "open internet 
connection" 으로 될수 있다 . 
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• 지름건이 충돌하지 않게 변경할수 있어야 한다. 례를 들면 영어로 ”& Quit " 는 
" Q " 를 포함하지 않는 노르웨이어의 " Avslutt " 로 된다. 우리는 이미 사용하고있는 문 
자를 사용할수 없으며 몇개의 지름건을 변경해야 한다. 

• 변수를 포함하는 구, 례 를 들면 《선택된 25개의 파일을 처 리하는데 63 s 걸린다》 
에서는 실행 시 에 2개의 수를 프로그람적 으로 삽입하며 다른 언어 에서 는 어 순과 변수의 
배치가 달라야 할수 있으므로 바꾸어 서술해야 할수 있다. 

Qt 번역도구는 이 문제를 간단하게 해결한다. 

제1절. 출하판관리기 

출하판관리기로서 2개의 도구 lupdate 와 lrelease 가 제공된다. 이 도구는 qmake 
프로젝트파일에 의존한다. 그러 나 반드시 qmake 를 사용하는것은 아니 다. 

세번째 도구 qm 2 ts 는 Qt 2 .x 통보문파일 을 .ts 파일 로 변환하는데 사용할수 있 다. 

1. Qt 프로젝트파일 

lupdate 와 lrelease 는 응용프로그람의 .pro Qt 프로젝트과일의 정보에 의존한다. 
자국어에 추가되는 매개 언어에 대하여 프로젝트파일의 TRANSLATIONS 절에 항목이 있 
어 야 한다. 전형적 인 항목은 다음과 같다. 

TRANSLATIONS = tt 2_ fr.ts \ 
tt 2_ nl.ts 

번역파일이름안에서 지역을 사용하면 실행시에 적재해야 할 언어를 결정하는데 도 
움이 된다. 이것은 3절에서 설명한다. 

4개의 번역원천파일 이 있는 완전한 .pro 파일의 례 : 

HEADERS = main - dlg.h \ 

options - dlg.h 

SOURCES t main - dlg.cpp \ 

options - dlg.cpp \ 
main.cpp 

FORMS = search - dlg.ui 

TRANSLATIONS = superapp dk.ts \ 
superapp _ fi.ts \ 
superapp no.ts \ 
superapp _ se.ts 

QTextCodec :: setCodecForTr () 는 tr () 호출내에서 나타나는 상수문자렬을 위한 
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8bit 부호화를 선택할수 있게 한다. 이것은 원천언어가 례를 들면 중국어이거나 일본어인 
응용프로그람에 도움이 된다. 만일 어떤 부호화도 설정하지 않으면 tr() 는 Latin-1 을 사 
용한다. 

만일 응용프로그람에 서 QTextCodec: :codecForTr() 기 구를 사용하면 Qt 

Linguist 는 .pro 파일안의 DEFAULTCODEC 항목도 설정할것을 요구한다. 실례 로 
DEFAULTCODEC = ISO-8859-5 

2. 1 update 

시■용법: lupdate myproject.pro 

이것은 간단한 지령행도구이다. lupdate 는 Qt .pro 프로젝트파일을 읽어들이고 지정 
된 원천, 머 리부와 Qt Designer 대 면부파일 안의 번역 가능한 문자렬들을 검 색 하고 프로젝 
트파일에 목록된 .ts 번역파일을 생성하고 갱신한다. 번역파일은 Qt Linguist 가 파일을 
읽 어 들여 번역 에 삽입하는데 사용하는 번역 프로그람에 주어 진다. 

자체의 번역프로그람을 가지고있으면 응용프로그람을 개발할 때 정기적으로(매달) 
lupdate 를 실행하는것이 유용하다는것을 알고있다. 이것은 프로젝트에 대한 번역작업이 
아주 적어지게 하고 번역프로그람이 많은 프로젝트를 동시에 지원하게 한다. 

필 요할 때 에 번 역 프로그람을 임 대받는 회 사들은 응용프로그람의 생 명 주기 에 서 극히 
얼마 안되는 시간만 lupdate 를 실행하는것이 좋을수 있다. 이것은 번역프로그람에 본질 
적 인 단일블로크의 작업을 제공하며 번역프로그람이 찾는 어떤 오유라도 처음의 시험단 
계에서 발견하기 쉽게 한다. 두번째와 그후의 lupdate 는 아마 최종적인 베타단계에서 
수행된다. 

.ts 파일형식은 필요하다면 판조종체계와 함께 사용할수 있고 사람이 읽을수 있는 단 
순한 XML 형 식 이 다. 

3. 1 release 

사용법 : lrelease myproject.pro 

이것은 또 하나의 간단한 지 령행도구이 다. 그것은 Qt .pro 프로젝트파일을 읽어들이 
고 프로젝트파일에 목록되는 각 .ts 번역원천파일에 대하여 응용프로그람에서 사용하 
는 .qm 파일을 생성 한다. .qm 파일형식은 상당히 빠른 검색을 번역에 제공하는 압축된 2 진 
형식이 다. 

이 도구는 초기 의 시 험관으로부터 최 종적 인 출하판까지 응용프로그람을 만들 때 항 
상 실행된다. .qm 파일들이 만들어지지 않으면 례를 들어 번역에 착수하기전에 알파판의 
발표가 요구되기때문에 프로그람작성 자가 원천파일에 배 치된 본문을 사용하여 응용프로 
그람이 아주 잘 실행되게 한다. .qm 파일들이 유효하면 응용프로그람이 그것 들을 찾아서 
자동적으로 사용한다. 
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lrelease 는 반드시 Done 으로 표식된 번역만 포함된다. 만일 번역이 실패하거나 
확증에서 실패하면 원시본문이 그대신에 사용된다. 

4. 번역실패 

lupdate 와 lrelease 는 둘다 완전하지 않은 .ts 번역원천파일과 사용될수 있다. 번역 
실패는 실행시에 자국어의 문구로 교체된다. 

제2절. 번역기 



1. Qt Linguist 사용에 관한 간단한 차림표 

Qt Linguist 는 Qt 응용프로그람에 번역을 추가하기 위한 도구이다. 여기서는 화면 
에 (실례 로 같은 차림 표나 대 화칸에) 함께 나타나는 한 그롭의 구들을 의 미 하는 번역문맥 
의 개념을 소개한다. 

과제띠차림표로부터 혹은 탁상그림기호를 두번 련속 누르고 지령행에서 linguist (이 
어서 Enter) 라고 입 력 하여 Qt Linguist 를 기동한다. Qt Linguist 가 기동하면 차림 표띠 
에서 File|Open 를 선택하고 작업하려는 .ts 번역원천파일을 선택한다. 

Qt Linguist 의 기본창문은 4 개의 기본구역으로 분할된다. 왼쪽에는 Context 목록， 
오른쪽우에 는 Source 본문구역 , 오른쪽중심 에 는 번 역 구역，오른쪽바닥에 는 구와 추측구 
역이 있다. 

문맥목록(왼쪽)에서 문맥중의 하나를 선택하고 Source 본문구역(오른쪽우)에 나타 
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나는 구중의 하나를 선택한다. 구는 번역구역(오른쪽중간)에 복사된다. 단어 
’ Translation ’ 아래를 선택하고 번역에 입력한다. Ctrl+Enter (Done & Next ) 를 눌러 
서 번역을 완료했다는것을 확인하고 번역을 요구하는 다음 구까지 이동한다. 

Ctrl + Enter 를 누른 다음 번역에 들어가는 주기는 모든 번역이 수행되거나 쎄션을 
끝낼 때까지 반복될수 있다. Linguist 는 열린 구서적과 이전의 번역들로부터 《구와 추 
측》구역을 가능한 번역으로 채우려고 한다. 매개는 지름건을 가지고있다. 례를 들면 
Ctrl +1, Ctrl +2 등은 번역구역으로 추측을 복사하는데 사용할수 있다. (마우스사용자는 
구 혹은 추측을 두번 눌러서 번역구역으로 그것을 움직일수 있다.) 세션의 끝에서 차림 
표띠 로부터 File | Save 를 선택한 다음 File | Exit 를 눌러 서 완료한다. 

2. Qt Linguist 의 기본창문 

1) 문맥목록 

이것은 기정으로 기본창문의 왼쪽에 나타난다. 첫째 렬 Done 은 문맥을 위한 번역 
이 수행되였는가를 확인한다. 검사표식은 번역이 끝나고 확증되였다는것을 가리킨다. 
물음표는 하나이 상의 번역 이 수행 되지 않았거 나 확증에서 실패 하였 다는것 을 가리 킨다. 
두번째 렬 Context 는 번역구가 나타나는 문맥의 이름이다. 셋째 렬 Items 은 2개 수를 
보여준다. 셋째는 수행된 번역수이고 두번째는 문맥에 있는 구의 개수이다. 수들이 같으 
면 모든 번역은 끝났다. 회색으로 된 검사표식은 이전의 번역 즉 응용프로그람의 이전판 
에서 번역되였는데 새로운 판에 번역하지 않은 구를 가리킨다. 

문맥은 영자모순으로 정렬된다. 각 문맥안에 있는 구들은 화면우에서 표시되는 순 
서가 아니라 원천프로그람에 나타나는 순서로 놓인다. 

Context List 는 류동가능창문이므로 기본창문의 다른 위치에 끌어가거나 기본창문 
밖으로 끌어가 자기의 오른쪽에 놓을수도 있다. Context List 를 움직 이면 Qt Linguist 
는 그 위치를 기억하고 프로그람을 기동할 때마다 그것을 본래상태로 되살린다. 

2) 원천본문구역 

이것은 기정적으로 기본창문의 오른쪽우에 나타난다. 첫째 렬 (’ Done ’) 은 번역상태 
를 보여준다. 검사표식은 구가 번역되고 확증되였다는것을 가리킨다. 물음표는 번역이 
완성되 지않았다는것 을 가리킨다. 느낌 표는 번역 이 확증에서 실패하였다는것 을 가리킨다. 
둘째 렬 ’Source text ’ 는 번역되여야 하는 본문을 보여준다. 셋째 렬은 번역을 보여준 
다. 

Qt Linguist 는 3종류의 확증을 제공한다. 즉 지름기호 ( accelerator ) ，구두점 
( punctua 吐 on ) 과 구이다. 만일 원천본문이 지름기호 즉 &이고 번역된 본문이 지름기호 
(즉 &) 를 포함하지 않으면 번역은 지름기호확증에 실패한다. 마찬가지로 원천본문이 특 
수구두점 례하면 ?，! 또는 .이고 번역 이 각이한 구두점으로 끝나면 번역은 구두점확증 
에 실패한다. 사용된 번역과는 다른 열린 성구집의 하나에 번역이 있으면 번역은 구두점 
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확증에 실패한다. 

원천본문령 역 은 류동가능창문이 다. 

3) 번역구역 

번역 구역 (Translation area ) 은 기 정 으로 기 본창문의 오른쪽 중심 에 나타난다. 여 
기 에는 3개의 수직구간들이 포함된다. 첫째 구간은 Source text 라고 표식되 여있고 그 
아래에 원천본문이 나타난다. 둘째 구간에는 프로그람작성자가 번역기를 방조하기 위하 
여 추가한 연청색배경의 문맥정보가 포함된다. 문맥정보가 주어지지 않았다면 이 구간은 
나타나지 않는다. 셋째 구간은 Transla 吐 on 으로 표식되여있고 여기는 원천본문의 번역 
을 써넣는 곳이다. 

4) 구 및 추측구역 

이 구역은 기정으로 기본창문의 오른쪽 아래에 나타난다. 새 구로 이동할 때 그 구 
가 적재되 여있는 성 구집들중 하나에 있으면 구가 이 구역안에 그 번역 문과 함께 나타난 
다. 구가 이미 번역된 다른 구와 같거나 비슷하다면 구와 번역문이 이 구역에 나타난다. 
구 및 추측구역 에서 번역문을 복사하려면 F 6 을 눌러서 구 및 추측구역 으로 옮기 고 올리 
와 내리화살건에 의하여 사용하려는 구로 옮기고 Enter 를 눌러서 복사한다. 후에 구를 
복사하지 않으려고 결심하였다면 Esc 를 누른다. 두 경우에 초점은 번역구역으로 돌아온 
다. 또한 사용하려는 번역문을 두번 찰칵하여 번역구역 에 로 복사한다. 

구 및 추측구역 (Phrases and Guesses Area ) 은 류동가능창문이 다. 

3. 공동과제 

1) 후번역 

번역을 그만두려고 한다면 Ctrl+L (Next Unfinished ) 을 눌러서 다음의 완료되지 
않은 번역으로 이동한다. 완료되지 않은 번역은 전혀 번역되지 않았거나 확증에서 실패 
한것 이다. 다음의 구로 이행 하려면 Shift + Ctrl + L 을 누른다. 또한 Transla 吐 on 차림표를 
리 용하여 항행할수 있 다. 완전히 다른 문맥 으로 이 행 하려 면 Context 목록에 서 작업 하려 
는 문맥을 찰칵하고 Source Text 구역에서 원천본문을 찰칵한다. 

2) 문맥에 따르는 여러개의 번역을 요구하는 구 

같은 구가 2개이상의 문맥에서 충돌없이 나타날수 있다. 일단 한개 문맥에서 구가 
번역되였으면 Qt Linguist 는 그것이 이미 번역되였다는것을 말하며 후에 번역기가 꼭같 
은 구와 만날 때 Qt Linguist 는 구와 추측구역 에서 이전의 번역문을 가능한 번역문후보 
로서 제공한다. 이전의 번역문을 받아들일수 있으면 Done & Next 단추를 찰칵하여 
( Alt + Enter 를 눌러서) 다음의 완료되지 않은 구로 이동한다. 

어떤 구가 특정문맥에 한번이상 발생하면 그것은 Qt Linguist 의 문맥목록에 오직 
한번 표시되며 그 번역은 그 문맥안의 모든 출현에 적 용된다. 같은 구가 같은 문맥 내 에 
서 다르게 번역되여야 한다면 프로그람작성자는 련관된 모든 구들에 대하여 각이한 주해 
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를 제공해야 한다. 그러한 주해들이 사용된다면 중복되는 구들이 문맥목록에 나타난다. 
프로그람작성 자들의 주해는 연청색 배 경우의 번역 구역 에 나타난다. 

3) 지름건변경 

지름건 (keyboard accelerator ) 은 눌렀을 때 응용프로그람이 작용을 수행 하게 하는 
건결합이 다. 보통 지름건은 Alt 건과 Ctrl 건형식의 지름건이다. 

Alt 지름건은 차림표와 단추들에 사용된다. 밑줄은 밑줄이 있는 문자를 Alt 건과 함 
께 누르는것이 마우스로 차림표항목을 찰칵하는것과 같다는것을 의미한다. 실례로 대다 
수 응용프로그람들은 " file ” 단어의 " F " 에 밑줄이 있는 File 차림표를 가지고있다. 이러한 
응용프로그람들에 서 파일 차림 표는 차림 표띠 의 " File " 단어 를 찰칵하거 나 Alt + F 건을 눌러 
서 펼칠수 있다. 밑줄있는 지름건은 그 앞에 &기호를 배치하여 지정한다. 실례로 &File 
을 들수 있다. 원천구가 &와 함께 나타나면 번역문도 갈은 문자의 앞에 &를 포함할수 
있다. Alt 지름건의 의미는 &가 매몰되는 구로부터 결정될수 있다. 번역기는 Alt 건과 함 
께 사용된 문자를 변경할 필요가 있을수 있다. 가령 번역된 구가 원시지 름문자를 포함하 
지 않는 경우이다. 다른 건들과의 충돌(즉 갈은 문맥에서 갈은 문자를 사용하는 두개의 
Alt 지름건이 있을 때)은 피하여 야 한다. 일부 Alt 지름건(보통 차림표띠우에 있는것들) 
을 다른 문맥에서 적용할수 있다. 

Ctrl 지 름건들은 시 각적 인 조종요소와 독립 적 으로 존재할수 있 다. 이 것 들은 흔히 여 
러개의 건치기나 마우스찰칵을 가지는 차림표의 작용들을 호출하는데 쓰인다. 또한 차림 
표나 단추에 나타나지 않는 작용들을 수행하는데 쓰일수 있다. 실례로 File 차림표를 가 
지는 대부분의 응용프로그람들은 New 라고 부르는 보조차림표를 가져야 한다. 대부분의 
응용프로그람들에서 이것은 " New ... Ctrl + N ’’ 로서 나타난다. 이 차림표선택은 마우스로 
File 을 찰칵하고 New 를 찰칵하여 펼칠수 있다. 혹은 Alt + F 를 누르고 밑줄이 있는 자을 
누를수 있다. 그러 나 단순히 Ctrl + Enter 를 눌러서 같은것을 달성 할수도 있다. Ctrl 건을 
사용하는 지름건들은 원천본문에 글자그대로(실례로 Ctrl + Enter ) 표시된다. Ctrl 지름건 
들은 구를 가지지 않으므로 번역기는 프로그람작성자에게 의거하여 오른쪽웃구획에 나타 
나는 " comment " 을 추가해 야 한다. 이 주석은 Ctrl 지름건이 수행 하는 작용에 대 하여 설 
명해야 한다. 실제로 Ctrl 지름건들은 단순히 그것들을 복사하고 Begin from Source 단 
추를 찰칵하여 번역한다. 그러나 일부 경우에 문자가 목표언어에서 의미를 가지지 않으 
므로 변경되여야 한다. 어떤 문자나 수자가 선택되든 번역은 항상 Ctrl 과 대문자나 수 
자의 결합이 여야 한다. Alt 지 름건들처 럼 번역 기 가 그 건을 변경 하는 경우에 다른 Ctrl 지 
름건과 충돌하지 말아야 한다. 

4) 변수들을 포함하는 구에 대한 론의 

어떤 구들은 변수를 포함한다. 변수들은 실행시에 채워지는 본문항목들을 위한 대 
리기호이다. 변수들은 원천본문에서 %기호와 수자들의 결합으로 지정된다. 실례로 
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After processing file %1, file %2 is next in line 을 들수 있다. 이 실례에서 %1은 실 
행시 에 처 리하려 는 첫 파일의 이름으로 교체되 고 %2는 처 리 해 야 할 다음 파일의 이름으 
로 교체된다. 번역판에서 변수들은 여전히 나타난다. 실례로 도이월란드번역문은 구들을 
역전할수 있다. 실례로 Datei %2 wird bearbeitet , wenn . Datei %1 fertig ist . 두 변 
수가 여전히 사용되지만 그 순서는 변경되였다. 변수들이 나타나는 순서에는 문제 가 없 
다. %1은 늘 실행시에 같은 본문으로 교체되며 원천본문이나 번역문에서 그것이 나타나 
는 순서 에는 문제가 없다. %2도 마찬가지 이다. 

5) 번역의 재리용 

번역된 본문이 원천본문과 류사하다면 Begin from Source 단추를 찰칵하여 ( Alt+T 
를 눌러서) 원천본문을 번역구역에 복사한다. 

Qt Linguist 는 자동적 으로 열 려진 성구집의 구들과 이미 번역되 여있는 류사하거 나 
갈은 구들을 구 및 추측구역에 렬거한다. 


4. 성구집의 창조와 사용 



그림 2-2. 성구집대화칸 

Qt Linguist 성구집은 원천구와 목표(번역된)구, 선택적인 정의들의 모임이다. 비록 
응용프로그람이나 한 계렬의 응용프로그람들마다 하나의 성구집 이 창조된다하여도 성구 
집은 응용프로그람과는 독립적으로 창조된다. 

번역기가 성구집의 원천구와 같은 번역되지 않은 구에 이르면 Qt Linguist 는 기본 
창문의 오른쪽아래의 Relevant phrases 판에 성구집항목을 표시한다. 성구집에서 주어 
진것들과 충돌하는 번역문들을 가지는 구에는 원천본문구획에서 물음표로 표식된다. 성 
구집은 번역문들의 공통모임을 제공하여 일관성을 담보하게 하는데 쓰인다. 또한 한 계 
렬의 응용프로그람들을 위한 번역문들이 성구집에서 일단 생성된 다음 노력의 중복을 피 


261 




















하는데 쓰이며 성구집은 매개 응용프로그람에서 대부분의 번역문들에 쓰인다. 

성구집을 편집하기전에 그것이 창조되여야 하며 또한 그것이 이미 존재한다면 열려 
져 있어 야 한다. 차림 표띠 로부터 Phrase | New Phrase BoOK 를 찰칵하여 새 로운 성 구집 
을 창조한다. 파일이름을 입력해야 하면 필요하다면 파일의 위치를 바끌수 있다. 새로 
창조한 성 구집 은 자동적 으로 열 려 진다. 차림 표띠 로부터 Phrase | Open Phrase BoOK 를 
찰칵하여 현존성구집을 연다. 

새로운 구를 추가하려면 New Phrase 단추를 찰칵하고(혹은 Alt+N 을 누르고) 새 
원천구에 입 력 한다. Tab 를 누르고 번역 에 입 력 한다. Tab 를 누르고 정의 를 입 력한다. 이 
것은 같은 원천구들의 각이한 번역을 구별하는데 쓸모있다. 이 과정을 필요할 때마다 반 
복할수 있다. 

구목록에서 구를 선택 하고 Remove Phrase 를 찰칵하여 삭제 할수 있 다. 

Save 단추를 찰칵하고 ( Alt+S 를 누르고) 구들을 일단 완료한(삭제한) 다음 Close 단 
추 ( Esc ) 를 누른다. 

구 혹은 구모임이 성구집에 나타날 때 필요한 목표구를 두번 찰칵하여 본문유표위 
치의 번역구획에 복사한다. 번역구획안의 본문을 목표구로 교체하려면 번역구획을 찰칵 
하고 Edit | Select All ( Alt + A ) 을 누른 다음 목표구를 두번 찰칵한다. 


5. 확중 

Qt Linguist 는 번역 구들에 대 한 3종류의 확증 ( validation ) 을 제공한다. 

€) 지름건확증은 원천구가 수행하는 경우와 반대로 하는 경우에 &를 가지지 않는 
번역된 구들을 탐지한다. 

② 구두점확증은 원천구와 번역된 구들사이의 마감구두점에서의 차이를 탐지한다. 
실례로 원천구가 생략기호，느낌표 혹은 물음표로 끝나면 경고하지만 번역된 구인 경우 
에는 경고하지 않는다. 

③ 구확증은 성구집에도 있는 원천구들을 탐지하지만 그 번역은 성구집에 주어지는 
것과 다르다. 

확증은 차림 표띠 의 Validation 항목으로부터 혹은 도구띠 단추들을 리 용하여 절 환한 
다. 확증에서 실패하는 구들은 원천본문구획에서 물음표로 표식된다. 확증을 차단하고 
후에 그것을 설정 한다. Qt Linguist 는 모든 구들을 다시 검사하고 확증에서 실패 한것을 
표식 한다. 

문맥안의 구가 무효이 면 문맥 자체 는 물음표로 표식 되 며 문맥안의 모든 구가 수행 되 
고 유효이면 그 문맥은 점으로 표식된다. 

수행된것으로(점으로) 표식되는 구들만 응용프로그람에서 나타난다. 무효한 구들과 
번역되지만 수행한것 으로 표시되지 않은 구들은 번역원천파일에 보관되지만 응용프로그 
람에 의해 사용되지 않는다. 
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6. Qt Linguist 참고 

1) 파일형 

Qt Linguist 는 3 종류의 파일을 사용하게 한다. 즉 

• .ts 번역원천파일은 원천구들과 그 번역문들을 포함하는 사람이 읽을수 있는 XML 
파일 들이다. 이 파일 들은 보통 lupdate 에 의 해 창조되 여 갱 신되 며 응용프로그람에 고유 
하다. 

• .qm Qt 통보문파일은 실행시에 응용프로그람에 의해 사용된 번역문들을 포함하는 
2 진파일 이 다. 이 파일들은 lrelease 에 의 해 생성되지 만 Qt Linguist 에 의 해서도 생성될 
수도 있다. 

•.qph Qt 성구집파일은 표준구들과 그 번역문들을 포함하는 사람이 읽을수 있는 
XML 파일이다. 이 파일들은 Qt Linguist 에 의해 창조되고 갱신되며 임의의 수의 프로 
젝트와 응용프로그람들에서 사용될수 있다. 

2) 차림표띠 

File £d 比 Iranslation Validation Phrases View Help 

그림 2-3. 차림표띠 

- File 

◦ pen ... Ctrl+O - 번역원천. ts 파일을 선택할수 있는 파일열기대화칸을 펼친다. 

Save Ctrl+S - 현재의 번역원천 .ts 파일을 보관한다. 

Save As ... - 파일보관대화칸을 펼치여 현재의 번역원천 .ts 파일을 다른 이름으로 
보관하거나 다른 위치에 넣을수 있게 한다. 

Release . .. - 파일보관대화칸을 펼친다. 입력한 파일이름은 현재번역원천파일에 기 
초한 번역의 Qt 통보문. qm 파일이다. 출하판관리기의 지령행도구 lrelease 는 응용프로그 
람의 번역원천파일 모두에 대하여 갈은 기능을 수행한다. 

Print ... Ctrl+P - 인쇄 대화칸을 펼친 다. OK 를 찰칵하면 번역 원천과 번역문들이 인 
쇄된 다. 

Recently opened files - 최근에 열었던 .ts 파일들을 표시 하고 하나를 찰칵하여 열 
수 있게 한다. 

Exit Ctrl+Q - Qt Linguist 를 닫는다. 

- Edit 

Undo Ctrl+Z - 번역구획에서 마지막 편집작용을 취소한다. 

Redo Ctrl+Y - 번역구획 에서 마지 막 편집 작용을 재시 행 한다. 

Cut Ctrl+X - 번역구획에서 선택된 본문을 삭제하고 사본을 오려둠판에 보관한다. 

Copy Ctrl+C - 번역구획에서 선택된 본문을 오려둠판에 복사한다. 

Paste Ctrl+V - 오려둠판본문을 번역구획 에 붙이기한다. 
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Select All Ctrl+A - 번역 구획 에서 복사 혹은 삭제 할 모든 본문을 선택 한다. 

Find ... Ctrl + F-Find 대화칸을 펼친다. 대화칸이 펼처질 때 검색하려는 본문을 입 
력 하고 Find Next 단추를 찰칵한다. 원천구와 번역 문, 주석 을 검 색할수 있다. 

Find Next F 3 - Find 대화칸에서 입력한 본문의 다음번 출현을 찾는다. 

- Translation 

Prev Unfinished Ctrl+K - 제 일 최근의 완료되지 않은 원천구로 이동한다. (완료 
하지 않았다는것 은 번역되 지 않았다는것 이 라든가 번역 은 되 였으나 확증에서 실패 하였 다 
는것을 의미 한다.) 

Next Unfinished Ctrl+L - 다음의 완료하지 않은 원천구로 이동한다. 

Prev Shift + Ctrl+K - 이전의 원천구로 이동한다. 

Next Shift + Ctrl+L - 다음의 원천구로 이동한다. 

Done & NextCtrl+Enter - 이 구를 번역이 수행된것으로 표식하고 다음의 완료되 
지 않은 원천구로 이동한다. 

Begin from Source Ctrl+B - 원천본문을 번역문에 복사한다. 

- Validation 

Accelerators - Alt 지 름건에 대 한 확증을 금지 혹은 설정 한다. 

Ending Punctuation - 구마감구두점 실례로 생 략기호，느낌표，물음표 등에 대하 
여 확증을 금지 혹寒 설정 한다. 

Phrase Matches - 현재 성구집 안에 있는 번역문들의 대조에 대 한 확증을 금지 혹 
은 설정한다. 

- Phrase 

New Phrase Book ... Ctrl+N - 파일 보관대 화칸을 펼 친 다. 성 구집 에 서 사용하려 는 
파일 이름을 입 력 하고 그 파일을 보관해 야 한다. 일단 보관한 다음 성구집을 열고 그것을 
사용할수 있다. 

Open Phrase Book ... Ctrl+H - 파일열기대화칸을 펼친다. 열려는 성구집을 찾고 
선택 한다. 

Close Phrase Book - 현재 성구집을 닫는다. 이것은 성구확증이 더는 발생 하지 않 
게 한다. Validation 차림 표나 구도구띠 단추에 의 하여 구확증을 금지 함으로써 같은 효과 
를 엄을수 있다. 

Edit Phrase Book .. . - 성 구들을 추가, 편집 혹은 삭제 하려 는 성 구집 대 화칸을 펼친 다. 

Print Phrase Book .. . - 인쇄 대 화칸을 펼 친 다. OK 를 찰칵하면 그 성 구집 이 인쇄 된 다. 

- View 

Revert Sorting - 원천본문구획안의 구들을 자기의 원래순서 로 넣는다. 

Display Guesses - 구 및 추측의 현시를 허 가 혹은 금지 한다. 
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Statistics - Statistics 대화칸의 표시를 절 환한다. 

Views - Context 과 Source 본문, Phrase 보기들의 표시 를 절환한다. 
Toolbars - 각이 한 도구띠들의 표시를 절환한다. 

3) 도구띠 


I 多圖立>1%||卜 ， x % ain |]4 - -방 

그림 2-4. 도구띠 

^ 새 로운 원천 .ts 파일을 열기 위하여 파일 열기 대 화칸을 펼친다. 

_ 현재 번역원천 .ts 파일을 보관한다. 

ᄅ 현재의 번역원천 .ts 파일을 인쇄한다. 

'增 새 로운 성구집 .qph 파일을 열기 위하여 파일열기대 화칸을 펼친다. 

° 번역구획에서 마지막 편집작용을 취소한다. 

번 역구획 에 서 마지 막 편집작용을 재 시 행한다. 

_ 번역 구획 에 서 선택 된 본문을 삭제 하고 사본을 오려둠판에 보관한다. 

^ 번역구획에서 선택된 본문을 오려둠판에 복사한다. 
ft 오려둠판본문을 번 역구획 에 붙이 기한다. 

H Find 대 화칸을 펼친다. 

ᅭ 이전의 원천구로 이동한다. 

다음의 원천구로 이동한다. 

이전의 완료되지 않은 원천구로 이동한다. 
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다음의 완료되지 않은 원천구로 이동한다. 

♦’ 이 구를 번역이 수행된것으로 표식하고 다음의 완료되지 않은 원천구로 이동 
한다. 


&■ Alt 지름건에 대한 확증을 금지 혹은 설정한다. 

- 구마감구두점에 대한 확증을 금지 혹은 설정한다. 

_ 성 구집확증을 금지 혹은 설 정 한다. 

4) Find 대화칸 



그림 2-5. Find 대화칸 

차림표띠로부터 Edit | Find 를 선택하거나 Ctrl + F 를 눌러서 Find 대화칸을 펼친다. 
F 3 을 눌러서 마지막 검색을 반복한다. 기정으로 원천구와 번역문, 주석들은 모두 검색 
되며 검색은 대소문자를 구별한다. 이러한 설정은 검사칸들을 검사하거나 검사를 해제하 
여 자기의 기호에 맞게 변경할수 있다. 

5) Phrase 대화칸 

이 대화칸은 소절 4. 에서 설명 한다. 

제3절. 프로그람작성자 

Qt 응용프로그람에서 다국어의 유지는 아주 간단하며 프로그람작성자에게 약간한 부 
담을 요구한다. 

Qt 는 구들이 만들어지는 각 창문에 대하여 구를 번역하므로 번역사용비용을 최소화 
한다. 대부분의 응용프로그람들에서 기본창문은 한번만 만들어 진다. 대화칸은 보통 창조 
된 다음 표시되고 필요에 따라서 숨겨진다. 초기의 번역이 진행되였다면 번역된 창문에 
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대 한 부담은 더는 없 다. 생 성 파괴 되 였 다가 다시 생성되는 창문들만 번역 비용을 가진다. 

Qt 에서는 실행시에 언어를 절환할수 있는 응용프로그람을 만들수 있으나 프로그람 
작성 자의 일 정 한 간섭 을 요구하고 약간의 실 행 시 비 용을 요구한다. 

1. 응용프로그람번역의 인식 

응용프로그람이 적 당한 번역파일을 찾아서 적재한 다음 프로그람작성 자들은 사용자 
가 볼수 있는 본문과 Ctrl 지름건을 번역목표로 표식한다. 

번역을 요구하는 매개 본문은 번역기가 프로그람에서 본문이 있는 위치를 확인할것 
을 요구한다. 각이한 번역을 요구하는 여러개의 같은 본문인 경우에도 번역기는 원천본 
문의 번역에 필요한 정보를 요구한다. 번역을 위한 본문선택은 자동적으로 클라스이름을 
기초문맥정보로 사용되게 한다. 일부 경우에 프로그람작성자는 번역기를 도와주기 위한 
추가정보를 요구할수 있다. 

1) 번역파일생성 

번역파일들은 응용프로그람에서 사용자가 볼수 있는 모든 본문과 Ctrl 건지름기호 
그리고 그 본문의 번역으로 이루어진다. 번역파일은 다음과 같이 생성된다. 

W 처음에 lupdate 를 실행하여 사용자가 볼수 있는 모든 본문만 있고 번역은 없 
는 . ts 번역원천파일의 한조를 생성한다. 

運) .ts 파일들은 Qt Linguist 를 사용하여 번역을 추가하는 번역기에게 주어진다. Qt 
Linguist 는 변경되거나 삭제된 어떤 원천본문이라도 처리한다. 

@ lupdate 를 실행하여 응용프로그람에 추가되는 새로운 본문을 삽입한다. 
lupdate 는 응용프로그람에서 사용자가 볼수 있는 본문을 번역과 동조시키며 어떤 자료 
도 파괴 하지 않는다. 

④ 필요하다면 걸음②와 ③을 반복한다. 

⑥ 응용프로그람의 발표가 요구될 때 lrelease 가 실행되여 .ts 파일을 읽고 실행시에 
응용프로그람에 의해 사용되는 .qm 파일을 생성한다. 

lupdate 가 성과적으로 작업하기 위하여서는 생성해야 할 번역파일을 알아야 한다. 
파일들은 단지 응용프로그람의 .pro Qt 프로젝트파일에 목록화된다. 례를 들면 
TRANSLATIONS = tt 2_ fr.ts \ 
tt 2_ nl.ts 

2) 번역의 적재 

int main ( int argc , char **argv ) 

{ 

QApplication app ( argc , argv ); 

이것은 Qt 응용프로그람의 단순한 main () 함수를 시작하는 방법이다. 
int main ( int argc , char **argv ) 


267 






{ 

QApplication app( argc, argv ); 

QTranslator translator( 0 ); 
translator.load( "ttlja", ); 
app.installTranslator( &translator ); 

번역 인식응용프로그람을 위하여 번역기객체가 생성되고 번역이 적재되고 응용프로 
그람에 번역기객체가 설치된다. 

int main( int argc, char **argv ) 

{ 

QApplication app( argc, argv ); 

QTranslator translator( 0 ); 

translator.load( QS 仕 ing("tt2_") + QTextCodec :: locale(), ); 
app.installTranslator( &translator ); 

생성응용프로그람에서 더 유연한 수법(례를 들면 지역에 따르는 번역적재)이 적합 
할수도 있다. 만일 .ts 파일 이 appname_locale (례를 들면 tt2_fr, tt2_de 와 같은 관례를 따 
라 모두 이름을 지 으면 우의 코드는 실행시 에 현재지 역의 번역 을 적재한다. 

현재지역용의 어떤 번역파일도 없으면 응용프로그람은 원시원천본문을 사용 한다 . 

3) 응용프로그람이 사용자가 볼수 있는 문자렬을 번역하기 

사용자가 볼수 있는 문자렬은 tr() 호출안에 그것을 넣어서 번역목표로 표식한다. 례 
를 들면 

button = new QPushButton( "&Quit", this ); 

은 다음과 같아진다. 

button = new QPushButton( tr("&Quit"), this) : 

Q_OBJECT 마크로를 사용하는 모든 QObject 보조들라스는 tr() 함수를 실현한다. 

보통 仕 () 가 QObject 보조들라스의 성원함수로서 호출되므로 그 호출이 직접 이루어 
진다 하더라도 다른 경우에 명시적인 콜라스이름을 제공할수 있다. 례를 들면 
QPushButton ： ： tr("&Quit") 

혹은 

QObject :: tr("&Quit") 

4) 다른 번역을 요구하는 같은 문자렬들의 식별 

lupdate 프로그람은 자동적으로 각 원천본문에 대하여 문맥을 제공한다. 이 문맥은 
tr() 호출을 포함하는 들라스의 이름이다. 이것은 거의 대부분의 경우에 충분하다. 그러나 
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때때로 번역기는 원천본문을 유일하게 확증하기 위하여 그 이상의 정보를 요구한다. 실 
례로 2 개의 분리된 틀을 포함하는 대화칸을 들수 있는데 매개 틀에는 Enabled 선택이 
포함되여있으며 일부 언어들에서 둘사이 에 번역 이 차이나므로 매개의 식 별이 요구된다. 
이것은 tr() 호출의 2 인수형 식 을 사용하여 쉽게 달성한다. 례 를 들면 

rbc = new QRadioButton ( trC ' Enabled ", "Color frame "), this ); 

과 

rbh = new QRadioButton ( trC ' Enabled ", "Hue frame "), this ); 

또한 Ctrl 건 지름기호를 번역할수 있다. 

file -> insertltem ( tr (" E & xit ") , qApp , SLOT (quit ()) , tr (" Ctrl + Q ", " Quit ") ); 

tr() 의 2 인수형식이 Ctrl 건 지름기호에 사용된다. 두번째 인수는 번역기가 지름기호 
에 의 해 처 리된 함수와 관련되 여있다는 유일 한 근거 이 다. 

5) 항행정보에 의한 번역기의 방조 

크고 복잡한 응용프로그람에서는 특별한 원천본문이 어디에 있는지 알기 힘들다. 
이것은 문제의 본문에 도달하기 위한 항행단계 를 서술하는 예 약어 TRANSLATOR 를 
사용하는 주석문을 추가하여 해결할수 있다. 례를 들면 
/* TRANSLATOR FindDialog 

Choose Edit | Find from the menu bar or press Ctrl+F to pop up the Find 
dialog . 

*/ 

이 설명문은 특히 창문부품 클라스에 쓸모있다. 

6) C++ 이름공간의 복사 

C++ 이름공간과 using namespace 명령문이 lupdate 를 혼란시킬수 있 다. 그것은 
MyClass 가 MyNamespace 이 름공간에서 정의된다해 도 MyClass: :仕 () 를 

MyNamespace: :MyClass: :仕 () 가 아니 라 단지 그자체 를 의 미 하는것 으로 해 석 할수 있 다. 그 
러므로 이 문자렬의 실행시번역 은 실패한다. 

MyClass :: 仕 () 를 사용하는 원천파일의 처음에 TRANSLATOR 설명문을 놓음으로써 
이 제 한에 대 하여 작업할수 있 다. 

/* TRANSLATOR MyNamespace: : MyClass */ 

설 명 문뒤 의 MyClass:: 仕 () 에 대 한 모든 참고는 MyNamespace::MyClass:: 仕 () 를 의 미 하는 
것으로 해석된다.. 

7) QObject 보조콜라스의 밖에 있는 본문의 번역 

QApplication :: translate 0 의 사용 

인용된 본문이 QObject 보조클라스의 성원함수안에 없으면 적당한 콜라스의 tr () 함 
수 혹은 QApplication : translate 0 를 직 접 사용한다. 
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void some _ global _ function ( LoginWidget *logwid ) 

{ 

QLabel *label = new QLabel ( LoginWidget :: tr ( M Password : M ), logwid ); 

} 

void same _ global _ function ( LoginWidget *logwid ) 

{ 

QLabel *label = new QLabel ( qApp -> translate (" LoginWidget M , " Password :"), 
logwid ); 

} 

QT _ TR _ NOOP () 와 QT _ TRANSLATE _ NOOP () 의 사용 

함수밖에서 번역가능한 본문을 완전히 가지고 있어야 한다면 2개의 마크로 즉 
QT _ TR _ NOOP () 와 QT _ TRANSLATE _ NOOP () 를 사용할수 있다. 이 마크로들은 단 
지 lupdate 에 의해 뽑아낼 본문을 선택할뿐이다. 마크로는 바로 본문(문맥없이)으로 전 
개 한다. 

QT _ TR _ NOOP () 의 실례: 

QString FriendlyConversation : : greeting ( int greet type ) 

{ 

static const char * greeting_strings [] = { 

QT _ TR _ NOOP ( " Hello " ), 

QT _ TR _ NOOP ( " Goodbye " ) 

}； 

return tr ( greeting _ strings [ greet _ type ] ); 

} 

QT _ TRANSLATE _ NOOP () 의 실례: 

static const char * greeting _ strings [] = { 

QT _ TRANSLATE _ NOOP ( " FriendlyConversation ", " Hello " ), 
QT _ TRANSLATE _ NOOP ( " FriendlyConversation ", " Goodbye " ) 

}； 


QString FriendlyConversation : : greeting ( int greet type ) 

{ 

return tr ( greeting _ strings [ greet _ type ] ); 

} 
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QString global _ greeting ( int greet_type ) 

{ 

return qApp -> translate ( " FriendlyConversation ", 
greeting 一 strings [ greet 一 type ] ); 

} 

2. 실례 

3 개의 실례를 제시한다. 첫 실례는 QTranslator 객체의 창조를 보여준다. 또한 사 
용자가 볼수 있고 번역하려 는 원천본문을 표식 하는데 tr () 함수를 사용하는 가장 간단한 
방법을 보여준다. 둘째 실례는 현재 지역에 적용할수 있는 번역파일을 응용프로그람이 
적재하게 하는 방법을 설명한다. 또한 2인수형식의 tr () 를 사용하여 번역기에 대한 추가 
정보를 제공하는 방법을 보여준다. 셋째 실례는 등가한 원천본문들이 같은 문맥에서 발 
생할 때에도 그것들을 구별하는 방법을 설명한다. 또한 응용프로그람이 갱신될 때 번역 
도구들이 번역기의 작업을 최소화하도록 방조하는 방법을 론의한다. 

1) 실례1: 번역의 적재와 사용 


FTffl -ini x| 

[]] ■권권[]| 

그림 2-6. 실례 1( 영문판) 

• ttl.pro 

TEMPLATE = app 

CONFIG += qt wam on 

SOURCES = main.cpp 

TRANSLATIONS = ttl _ la.ts 
• main.cpp 

// Translation tutorial 1 
#include < qapplication . h > 

#include < qpushbutton . h > 

#include < qtranslator . h > 

int main ( int argc , char **argv ) 

{ 

QApplication app ( argc , argv ); 

QTranslator translator ( 0 ); 
translator . load ( M ttl _ la n , ，?， ); 
app . installTranslator ( &translator ); 
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QPushButton hello( QPushButton: : tr("Hello world!"), 0 ); 
app.setMainWidget( &hello ); 
hello.show(); 
return app.exec(); 

} 

이 실례는 《Qt 일반지 식》 2 장 2 절의 " hello - world ” 실례를 라린문번역으로 다시 만 
든다. 그림 2-6 은 영문판을 보여준다. 

-프로그람설명 

#include <<^xanslator.h> 

이 행은 QTranslator 들라스의 정의를 포함한다. 이 콜라스의 객체들은 사용자가 
볼수 있는 본문에 대해 번역을 제공한다. 

QTranslator translator( 0 ); 

부모없는 QTranslator 객체를 하나 생성한다. 

仕 anslator.load( "ttl_la",); 

프로그람에서 사용되는 원천본문에 대한 라린번역을 포함하는 ttl_la.qm(.qm 파일확장 
자는 암시 적 이 다. ) 라는 파일 을 적 재하려 고 한다. 파일 이 발견되 지 않으면 어 떤 오유도 
발생하지 않는다. 

app. installT ranslator (&translator); 

ttl_la.qm 으로부터 프로그람에 의 하여 사용되 는 번역 풀 ( pool ) 에 로 번역 을 추가한다. 
QPushButtonhello( QPushButton: : tr("Hello world!"), 0 ); 

"Hello world !" 를 현시하는 누름단추를 하나 생성한다. ttl_la.qm 을 발견하고 
"Hello world !’’ 에 대한 번역을 포함한다면 번역이 나타나고 그렇지 않으면 나타나지 
않는다. 

QObject 를 계승하는 모든 콜라스들은 tr() 함수를 가지고있다. QObject 클라스의 성 
원함수안에서 QPushButton::tr("Hello world!") 혹은 QObject:: 仕 ("Hello world!’’) 대신에 간단히 
tr("Hello world!") 라고 쓴다. 

- 영문으로 응용프로그람의 실행 

번역파일 ttl_la.qm 를 만들지 않았으므로 응용프로그람을 실행할 때 원천본문이 표시 
된 다. 

- 라린통보문파일의 생성 

첫단계 는 프로젝 트를 위한 모든 원천파일들을 목록하는 프로젝 트파일 ( ttl . pro ) 을 만 
드는것이다. 프로젝트파일은 qmake 프로젝트파일 또는 심지어 보통의 makefile 일수 있 
다. 다음과 같이 

SOURCES = main.cpp 
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TRANSLATIONS = ttl _ la.ts 

를 포함하는 파일 을 작성한다. TRANSLATIONS 는 우리 가 유지 하려 고 하는 통보문파 
일을 지정한다. 이 실례 에서는 한조의 번역 (즉 라린)을 유지한다. 

파일 확장자는 .qm 이 아니 라 .ts 이 다. .ts 번역원천형 식 은 응용프로그람을 개 발할 때 사 
용하기 위하여 설계된다. 프로그람작성 자 또는 개 발관리자는 lupdate 프로그람을 실행하 
여 실행원천코드에서 추출되는 원천본문을 가진 .ts 파일을 생성하고 갱신한다. 번역기는 
번역을 추가하고 편집하는 Qt Linguist 를 사용하여 .ts 파일을 읽고 갱신한다. 

. ts 형식은 직접 전자우편으로 보낼수 있고 판조종하기 쉽고 사람이 읽을수 있는 
XML 이 다. 만일 이 파일 을 수동적 으로 편집한다면 XML 를 위한 기 정 부호화가 
Latin -1 (ISO 8859-1) 이 아니라 UTF -8 이라는것을 알고있다. ’ 0 ’( o 에 사선이 있는 노 
르웨이 어 )와 같은 Latin -1 문자로 입 력 하는 한가지 방법 은 XML 실 체 ”&# xf 8;" 를 사용 
하는것 이 다. 이것은 어떤 유니코드문자라도 작업한다. 

번역이 끝나면 lrelease 프로그람은 .ts 파일을 .qm Qt 통보문파일형식으로 바꾸는데 
사용된다. .qm 형식은 매우 빠른 탐색기능을 주기 위해 설계된 조밀한 2진형식이다. 
lupdate 와 lrelease 는 둘다 프로젝트의 전체 원천와 머 리부파일 (프로젝트파일의 
HEADERS 와 SOURCES 행 에 지정된 파일)들을 읽어들이고 tr() 함수호출에 나타나는 
문자렬들을 뽑아낸다. 

lupdate 는 원천코드와 동조하여 유지 하도록 통보문파일(이 경우에 ttl _ la . ts ) 들을 생 
성하고 갱신하는데 사용된다. 언제든지 lupdate 를 실행하는것은 안전하다. lupdate 는 
정보도 조금도 삭제하지 않는다. 례를 들면 그것을 makefile 에 넣어서 원천이 변경될 
때마다 . ts 파일을 갱신할수 있다. 

다음과 같이 lupdate 를 실행할수 있다. 
lupdate -verbose ttl.pro 

(- verbose 선택 은 lupdate 에 게 그것 이 무엇 을 하고 있는가를 설 명 하는 통보문를 표시 
하게 한다.) 현재 등록부에는 다음의 내용을 포함하는 파일 ttl _ la . ts 가 있어 야 한다. 

<!DOCTYPE TS >< TS > 


〈 context 〉 

< name > QPushButton </ name > 

< message > 

< source>Hello world ! </ source > 

〈translation type =" unfinished M ></ translation > 
</ message > 

〈/ context 〉 

</ TS > 
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이 파일은 도구 ( lupdate , Qt Linguist , lrelease ) 를 사용하여 읽어들이고 갱신하 
므로 파일형식을 해석할 필요가 없다. 

- Qt Linguist 에 의하여 라린문으로 번역 

Qt Linguist 를 사용하여 번역을 제공한다. 그렇지만 XML 또는 평본문편집기를 사 
용하여 번역을 .ts 파일에 입력할수 있다. 

Qt Linguist 를 기동하려면 다음과 같이 입력한다. 
linguist ttl_la.ts 

지금 왼쪽웃구석에서 본문 ’’ QPushButton " 가 있다. 그것을 두번 련속 누르고 
"Hello world !” 우를 누르고 Translation 구획 (창문의 오른쪽 중간)에 " Orbis , te 
saluto !" 라고 입력한다. 느낌표!를 잊지 말아야 한다. 

Done 검사칸을 누르고 차림표띠에서 File | Save 를 선택한다. .ts 파일은 더 이상 
〈translation type= , unfinished , x/translation> 

을 포함하지 않지만 그대신 

<translation>Orbis, te saluto! 〈 /translation 〉 

를 가진다. 

- 라린문으로 응용프로그람의 실행 

라린어 로 실행하는 응용프로그람을 보기 위하여 . ts 파일로부터 . qm 파일을 생성 해 야 한 
다. . qm 파일은 Qt Linguist 로부터 (하나의 . ts 파일을 위해) 생성하거나 혹은 프로젝트파일 
에 목록되는 매개 . ts 파일에 대하여 하나의 . qm 파일을 생성하는 지령행프로그람 lrelease 
를 사용하여 생성 할수 있다. Qt Linguist 의 차림표띠 에서 File | Release 를 선택하고 올리 
펼쳐지는 파일보존대 화칸에서 Save 를 눌러서 ttl _ la . ts 로부터 ttl _ la . qm 을 생성한다. 이제 
竹1실례프로그람을 다시 실행한다. 이번에 단추에는 " Orbis , te saluto !” 로 된다. 

□21 -Ini x| 

j Orbisjesaluto! ]| 

그림 2-7. 실례 1( 라린어판) 

2) 실례2: 2개이상 언어의 사용 



그림 2-8. 실례 2( 영문판) 
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•t 接 . pro 

TEMPLATE - app 

CONFIG += qt wam on 

HEADERS = arrowpad.h \ 

mainwindow.h 

SOURCES = arrowpad.cpp \ 

main.cpp \ 
mainwindow.cpp 
TRANSLATIONS = tt2_fr.ts \ 
tt2_nl.ts 

이 실례는 좀 더 복잡하며 중요한 Qt Linguist 개념문맥을 소개한다 . 

• arrowpad.h 는 사용자정의창문부품 ArrowPad 의 정의를 포함한다 . 

• arrowpad.cpp 는 ArrowPad 의 실현을 포함한다 . 

• mainwindow 上는 QMainWindow 의 보조클라스 MainWindow 의 정의를 포함한다 . 

• mainwindow.cpp 는 MainWindow 의 실현을 포함한다 . 

•main.cpp 는 main() 를 포함한다 . 

2 개의 번역 프랑스어와 네테를란드어를 사용하지만 응용프로그람에서 사용가능한 
번역의 수에 대한 어떤 효과적인 제한도 없다 . tt2.pro 의 련관된 행들은 다음과 같다 . 
HEADERS = arrowpad.h \ 

mainwindow.h 

SOURCES = arrowpad.cpp \ 

main.cpp \ 
mainwindow.cpp 
TRANSLATIONS = tt2_fr.ts \ 
tt2_nl.ts 

lupdate 을 실행 하면 2 개의 등가한 통보문파일 tt2_fr.ts 와 tt2_nl.ts 를 만들어 낸다 . 이 
파일들은 tr() 호출에 의해 번역하려고 표식한 모든 원천본문들과 그 문맥들을 포함한다 . 

- 프로그람설명 

arrowpad.h 에 서 는 QWidget 의 파생 클라스인 ArrowPad 클라스를 정 의 한다 . 그림 2-8 
에서 4 개의 단추를 가지는 중심창문부품이 ArrowPad 이다 . 
class ArrowPad : public QGrid 

lupdate 를 실행하면 원천본문만 꺼내는것 이 아니 라 그것들을 문맥들로 묶는다 . 문 
맥은 원천본문이 나타나는 클라스의 이름이다 . 이리하여 이 실례에서 ’’ArrowPad” 는 
문맥 이 고 그것 은 AirowPad 클라스안에 있는 본문들의 문맥 이 다 . Q_OBJECT 마크로는 
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ArrowPad 에 서 tr(x) 를 다음과 같이 정 의한다. 

qApp->translate( "ArrowPad", x) 

매개 원천본문이 나타나는 콜라스를 알면 Qt Linguist 가 론리적으로 모두 련관된 
본문들을 묶을수 있게 한다. 실례로 대화칸의 모든 본문은 대화칸의 콜라스이름의 문맥 
을 가지며 모두 표시된다. 이것은 본문이 나타나는 문맥이 번역방법에 영향을 줄수 있으 
므로 번역기에 유용한 정보를 제공한다. 일부 번역에서 지름건들은 변경할 필요가 있으 
며 모두 묶어진 특정 한 문맥(클라스)안의 모든 원천본문을 취 하여 번역기가 총돌을 일으 
킴이 없이 지름건의 변경을 간단히 수행하게 한다. 

arrowpadcpp 에 서 는 ArrowPad 클 라스를 실현 한다. 

(void) new QPushButton( tr("&Up"), this ); 

표식자가 사용자가 볼수 있는 본문이므로 매개 단추의 표식에 대하여 ArrowPad::tr() 
를 호출한다. 

class MainWindow : public QMainWindow 

{ 

QOBJECT 

그림 2-8 에서 전체 창문은 하나의 MainWindow 이다. 이것은 mainwindow.h 머리부파 
일에 정의된다. 여기서도 Q_OBJECT 를 사용하므로 MainWindow 는 Qt Linguist 안의 문 
맥 으로 된다. 

MainWindow, mainwindow.cpp 의 실현에서 는 ArrowPad 클라스의 실례 를 창조한다. 

ArrowPad *ap = new ArrowPad( this, "arrow pad"); 

또한 MainWindow::tr() 를 두번 호출한다. 한번은 차림표항목에 대하여 또한번은 지 
름건에 대하여 호출한다. 

file->insertltem( tr("E&xit"), qApp, SLOT(quit()), 仕 ("Ctrl+Q", "Quit") 效 

tr() 의 사용은 다른 언어 들에 서 서 로 다른 건들을 유지한다. "Ctrl+Q" 는 영 문에 서 
Quit 의 좋은 선택이지만 네테를란드번역기는 ”Ctrl+A” (Afsluiten) 를 사용할것을 요구 
하며 도이월란드번역기는 "Strg+E” (Beenden) 를 요구한다. Ctrl 지름건에 仕 () 를 사용할 
때 둘째 인수가 지름건이 수행하는 기능을 서술하는 2인수형식을 사용해야 한다. 

main() 함수는 보통과 같이 main.cpp 에서 정의된다. 

QTranslator translator( 0 ); 

仕 anslator.load( QString("tt2_") + QTextCodec::locale(),); 

app.installTranslator( &translator); 

현재 지역에 따라서 사용하려는 번역을 선택한다. 가령 QTextCodec::locale 0은 
LANG 환경변수의 설정 에 의해 영 향을 받을수 있다. .qm 통보문파일들(과 .ts 파일들)을 위 
한 지역을 결합하는 명명관례의 사용이 지역에 따르는 번역파일의 선택을 실현하기 쉽게 
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한다. 

선택된 지역에 대한 . qm 통보문파일이 없으면 원래 원천본문이 사용되고 오유가 일 
어나지 않는다. 

- 프랑스어와 네테를란드어로 번역 

우선 실 례응용프로그람을 프랑스어 로 번역하자. tt 2_ fr . ts 를 가지 고 Qt Linguist 를 기 
동한다. 두개의 문맥 (’’ ArrowPad " 와 " MainWindow ") 안에 그롭화된 7개의 원천본문 
들 (”& Up "，"& Left " 등)을 엄어야 한다. 

이제 다음의 번역을 입력한다. 

一 ArrowPad 
&Up - &Haut 
技 Left — 技 Gauche 
&Right - &Droite 
技 Down — 技 Bas 

- MainWindow 

E 技 xit — SQuitter 
Ctrl+Q - Ctrl+Q 
技 File - 技 Fichier 

매번 번역을 입력한 다음 Alt + D(Done & Next 단추를 찰칵)를 누르는것이 가장 빠 
르다. 이것은 번역을 수행한것으로 표식하고 다음 원천본문으로 이동한다. 

파일을 보관하고 tt2_nl.ts: 를 가지 고 네테 를란드어 에 대 하여 같은 조작을 수행한다. 

一 ArrowPad 
&Up - &Boven 
&Left 一 技 Links 
&Right 一 技 Rechts 
技 Down — &Onder 

- MainWindow 

E 技 xit — SAfsluiten 
Ctrl+Q - Ctrl+A 
File - SBestand 

ttl_fr.ts 과 ttl_nl.ts 번역 원천파일 들을 .qm 파일들로 변환하여 야 한다. 이 전에 수행 한것 
처럼 Qt Linguist 를 사용할수 있으나 지령행도구 lrelease 를 사용하여 Qt Linguist 로 
부터 매개 파일을 개별적으로 적재하고 File | Release 함이 없이 응용프로그람을 위한 모 
든 .qm 파일들을 창조한다는것을 담보한다. 

실천에서는 응용프로그람의 makefile 에 lupdate 와 lrelease 의 호출을 포함하여 마 
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지막 번역들이 사용되도록 담보한다. 

다음과 같이 입력한다. 

1 release tt 2 .pro 

이 것은 tt 2_ fr . qm 와 tt 2_ nl . qm 를 둘다 창조한다. LANG 환경 변수를 fr 로 설정 한다. 
Unix 에 서 는 다음의 두 지 령 들중 하나가 작업해 야 한다. 
export LANG=fr 
setenv LANG fr 

Windows 에 서 는 autoexec . bat 를 수정 하거 나 다음과 같이 실 행한다. 
set LANG=fr 

이 제 프로그람을 실 행하면 프랑스판을 볼수 있 다(그림 2-9). 



그림 2-9. 실례 2( 프랑스판) 

LANG = nl 라고 설정 하고 네테를란드어 로 같은것을 수행한다. 이제는 네테를란드판이 
나타난다. 



그림 2-10. 실례 2( 네테를란드판) 

- 련습문제 

Qt Linguist 에 서 수행 하지 않은 번역들중 하나를 표식 한다. 즉 " done " 검사칸을 해 
제한다. 그리고 lupdate 를，그다음 lrelease , 그다음 실례를 실행한다. 이러한 변경이 
어떤 효과를 가지는가? 
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LANG=fr_CA (프랑스 카나다)로 설정 하고 실례프로그람을 다시 실행한다 . 결과가 
LANG=fr 인 경우와 같은 원인을 설명하시오 . 

&Bestand 와 SBoven 사이의 충돌을 없애기 위하여 네테를란드번역에서 지름건들중 
하나를 변경한다 . 

3) 실례 3: 등가한 문자렬들의 애매한 점 을 없앤다 



그림 2-11. 실례 3, "Troll Print 1.0" 영문판 

•tt3.pro 

TEMPLATE ■•■app 
CONFIG qt wam_on 

HEADERS ■: ■vmainwindow.il \ 

printpanel.h 

SOURCES = mainxpp \ 
mainwindow.cpp \ 
printpanel.cpp 

TRANSLATIONS = tt3_pt.ts 

이 실례 에 대 하여 뽀르뚜갈어번역 문들을 포함하는 번역파일 tt3_pt.ts 을 포함하였 다 . 
같은 응용프로그람의 2 개의 출하판 Troll Print 1.0 과 1.1 을 고찰한다 . 첫 출하판 
용으로 창조한 번역문들을 다음의 출하판에서 재리용하는 방법을 학습한다 . (이 실례에 
서는 일부 원천파일들을 편집할 필요가 있다 . 새로운 일시등록부에 모든 파일들을 복사 
해두고 거 기서 작업 하는것 이 아마 제 일 좋을것 이 다 . ) 

Troll Print 는 사용자가 인쇄기환경을 선택하게 하는 장난감과 같은 실례프로그람 
이 다 . 두개의 판 즉 영문판과 뽀르뚜갈문판이 있다 . 

판 1.0 은 다음의 파일들로 이루어진다 . 

• printpanel.h 는 PrintPanel 의 정의를 포함한다 . 

• printpanel.cpp 는 PrintPanel 의 실현을 포함한다 . 

• mainwindow.h 는 MainWindow 의 정의를 포함한다 . 
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• mainwindow.cpp 는 MainWindow 의 실현을 포함 한다 . 

•main.cpp 는 main() 을 포함한다 . 

• tt3.pro 는 qmake 프로젝 트파일 이 다 . 

•tt3_pt.ts 는 뽀르뚜갈어 통보파일 이다 . 

- 프로그람설명 

PrintPanel 는 printpanel.h 에서 정의된다 . 
class PrintPanel : public QVBox 
{ 

Q_OBJECT 

PrintPanel 는 QWidget 이다 . tr() 가 적당히 작업하려면 Q_OBJECT 마크로를 요구한다 . 

실 현 파일 은 printpanel.cpp 이 다 . 

/* 

QLabel *lab = new QLabel( tr("<b>TROLL PRINT</b>"), this ); 
lab->setAlignment( AlignCenter ); 

*/ 

Troll Print 1.0 에서 일부 코드는 설명문으로 하였는데 후에 Troll Print 1.1 에서 
그것을 실행문으로 고친다 . 

QHButtonGroup *twoSided = new QHButtonGroup( this ); 

twoSided->setTitle( tr("2-sided n ) ); 

but = new QRadioButton( tr("Enabled’’)，twoSided ); 

but = new QRadioButton( tr(’’Disabled’’)，twoSided % 

but->toggle(); 

QHButtonGroup * colors = new QHButtonGroup( this ); 

colors->setTitle( tr("Colors”) ); 

but = new QRadioButton( tr(’’Enabled"), colors ); 

but = new QRadioButton( tr(’’Disabled"), colors ); 

but->toggle(); 

PrintPanel 에 서 tr(’’Enabled") 와 tr( n Disabled n ) 가 두번 출현 한다 . "Enabled" 와 
"Disabled” 들이 둘다 같은 문맥에서 나타나므로 Qt Linguist 는 매개의 하나의 출현만 
현시하며 현시하지 않는 중복되는것들에 대해서는 같은 번역을 사용한다 . 이것은 뽀르뚜 
갈어와 갈은 일부 언어들에서 시간을 절약하는데 아주 쓸모있으며 한편 두번째 출현은 
따로따로의 번역을 요구한다 . Qt Linguist 가 따로따로 번역하는데 맞게 모든 출현을 현 
시하도록 하는 방법을 간단히 고찰하자 . 

MainWindow 의 머리부파일 mainwindow.h 은 새로운것을 포함하지 않는다 . 실현파일 
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mainwindow.cpp 에는 번역에 대하여 표식되여야 하는 사용자가 볼수 있는 원천본문들이 
있 다 . 

setCaption( tr( M Troll Print 1.0") ); 

창문의 제 목을 번역해 야 한다 . 

file->insertltem( tr ( ， ’ E&xit，，), qApp, SLOT(quit()), tr("Ctrl+Q n , "Quit") ); 

QPopupMenu *help = new QPopupMenu( this ); 
help->insertltem( tr(’’&About”), this, SLOT(about()), Key 一： FI ); 
help->insertltem( tr("About &Qt”), this, SLOT(aboutQt()) ); 
menuBar()->insertItem( tr("&File"), file ); 
menuBar()->insertSeparator(); 
menuBar()->insertItem( tr( M &Help"), help ); 

또한 차림표항목들도 번역해야 한다 . 2 인수형식의 tr() 가 지름건 ’’Ctrl+Q M 에 사용되 
며 둘째 인수는 그 지름건이 수행하는 기능이 무엇인가를 번역기가 가리키는 유일한 실 
마리이 다 . 

QTranslator translator( 0 ); 

仕 anslator.load( QS 仕 ing("tt3_") + QTextCodec :: locale(), ); 

app.installTranslator( &translator ); 

main.cpp 의 main() 함수는 실례 2 에서와 같다 . 특히 이 함수는 현재 지역에 기초하여 
번역 파일 을 선택한다 . 

- 영문과 뽀르뚜갈어로 Troll Print 1.0 의 실행 

제공되 여있는 tt3_pt.ts 파일의 번역을 리용한다 . 

LANG 환경변수를 마로 설정한 다음 tt 3 를 실행한다 . 여전히 그림 2-11 에서 보여준바 
와 같이 영문이 표시되여야 한다 . 이제 lrelease 실례로 lrelease tt3.pro 를 실행하고 다시 
실례를 실행한다 . 그러면 뽀르뚜갈어판 (Troll Imprimir 1.0) 이 표시되여야 한다 . 



그림 2-12. 실례 3, "Troll Imprimir 1.0", ( 나쁜 ) 뽀르뚜갈판 


281 















번역은 정확히 표시되였으나 사실상 나쁘다 . 좋은 뽀르뚜갈문에서 " Enabled " 의 두 
번째 출현은 ’’ Ativado " 가 아니라 " Ativadas " 로 되여야 하고 " Disabled " 의 둘째번역의 
마감에도 마찬가지로 변경되여야 한다 . 

Qt Linguist 를 리용하여 tt3_pt.ts 을 열면 번역원천파일안에 " Enabled " 과 
" Disabled " 의 바로 한번 출현하는것을 볼수 있다 . 그렇지만 원천코드안에 각각 두개씩 
있다 . 이것은 Qt Linguist 가 중복되는 원천본문에는 갈은 번역문을 사용함으로써 번역 
기의 작업을 최소화하려고 하기때문이다 . 하나의 동일한 번역이 틀리는 경우에 프로그람 
작성자는 중복되는 출현에서 모호한 점을 없애야 한다 . 이것은 2 인수형식의 tr() 를 사용 
하여 쉽게 이루어진다 . 

번역기의《문맥》이 사실상 변경되여야 할 본문이 나타나는 들라스의 이름이므로 어 
느 파일이 변경되여야 하는가를 쉽게 결정할수 있다 . 이 경우에 파일은 printpanelxpp 이 
고 거 기 에는 변경해 야 할 행 이 4 개 있다 . 라지오단추들의 첫 쌍에 대 한 적 당한 tr() 호출 
들에 둘째 인수 " two - sided " 를 추가한다 . 

but = new QRadioButton( 仕 ("Enabled", "two-sided"), twoSided); 
but = new QRadioButton( tr("Disabled", "two-sided"), twoSided); 

그리고 라지오단추들의 둘째 쌍에 대한 적당한 tr() 호출들에 둘째 인수 " colors " 를 
추가한다 . 

but = new QRadioButton( tr("Enabled", "colors"), colors ); 
but = new QRadioButton( tr("Disabled", "colors"), colors ); 

이제는 lupdate 을 실행하고 Qt Linguist 에서 tt3_pt.ts 을 연다 . 그러면 두가지 변경 
을 볼수 있다 . 

첫째로 , 지금 번역원천파일은 3개의 ’’ Enabled ", ” Disabled " 쌍을 포함한다 . 첫째 
쌍은 ”( obs .)” 로 표시하여 그것들이 낡은것 이 라는것을 보여준다 . 그것은 이 본문들이 2 
인수를 가진 새로운 호출들로 교체된 tr () 호출에 나타났기때문이다 . 둘째 쌍은 주석으로 
서 " two - sided " 를，셋째 쌍은 " colors " 를 가진다 . 주석은 Qt Linguist 의 원천본문과 
주석구역에 표시된다 . 

둘째로，번역본문 " Ativado ” 와 " Desativado " 는 새로운 ’’ Enabled " 과 ” Disabled ” 
본문들용의 번역과 같이 자동적으로 사용되여 번역기의 작업을 최소화한다 . 물론 이 경 
우에 매개 단어가 두번째 로 출현하는 경우에 정 확하지 않지만 좋은 출발점을 제공한다 . 

두번째의 " Ativado " 를 " Ativadas ” 로，두번째의 " Desativado " 를 " Desativadas " 
로 변경 한 다음 보관하고 완료한다 . lrelease 를 실행 하여 갱신된 2진파일 tt 3_ pt.qm 을 얻 
고 Troll Print (혹은 Troll Imprimir ) 를 실행 한다 . 
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그림 2-13. 실례 3, "Troll Imprimir 1.0", ( 좋은 ) 뽀르뚜갈판 

Qt Linguist 에서 《 주석》이 라고 부르는 tr () 호출에 로의 제 2 인수는 같은 문맥 (콜라 
스 ) 에 서 발생하는 동일 한 원천본문들사이 를 구별 한다 . 그것들은 또한 번역 기 에 실마리 를 
주기 위하여 다른 경우들에 사용할수 있으며 Ctrl 지름건의 경우에는 번역기에로의 지름 
건에 의하여 수행된 기능을 전달하는 유일한 수단이다 . 

번역기를 방조하는 추가적인 방법은 번역해야 할 원천본문들을 포함하는 응용프로 
그람의 특정부분에로 항행하는 방법에 대한 정보를 제공하는것이다 . 이것은 번역문이 나 
타나는 문맥을 알수 있게 방조하며 또한 번역문들을 찾고 시험 하는데 도움을 준다 . 이것 
은 원천코드에서 TRANSLATOR 주석을 히용함으로써 이루어진다 . 

/* TRANSLATOR MainWindow 

In this application the whole application is a MainWindow. 

Choose Help|About from the menu bar to see some text 
belonging to MainWindow. 

*/ 

일부 원천파일들에 특히는 대화칸클라스들에 주석을 추가하여 대화칸에 도달하는데 
필요한 항행을 서술한다 . 또한 실례파일들에 주석을 추가할수 있다 . 실례로 
mainwindow.cpp 와 printpanel.cpp 가 적 당한 파일 이 다 . lupdate 을 실행 한 다음 Qt 
Linguist 를 기동하고 tt3_pt.ts 를 적재한다 . 원천본문을 열람할 때 원천본문 및 주석구역 
에서 주석을 볼수 있다 . 

때때로 특히 대규모프로그람들에서 번역기가 그 번역문들을 찾고 그것들이 정확한 
가를 찾기는 힘들다 . 좋은 항행정보를 제공하는 주석은 시간을 절약할수 있다 . 

/* TRANSLATOR ZClientErrorDialog 

Choose Client|Edit to reach the Client Edit dialog, then choose 
Client Specification from the drop down list at the top and pick 
client Bartel Leendert van der Waerden. Now check the Profile 
checkbox and then click the Start Processing button. You should 
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now see a pop up window with the text ’’Error: Name too long!". 

This window is a ZClientErrorDialog. 

*/ 

- Troll Print 1.1 

이제는 Troll Print 의 출하판 1.1 을 준비하자 . 자기가 좋아하는 본문편집기를 기동 
하고 다음과 갈은 걸음들을 수행 한다 . 

• printpanel.cpp 에서 본문 "<b>TROLL PRINT</b >” 를 가지는 QLabel 을 하나 창 
조하는 두개 행 의 주석 을 해 제한다 . 

• 단어 배 치 : printpanel.cpp 에 서 "2—sided" 를， ’ Two-sided ” 로 교체 한다 . 

• mainwindow.cpp 에 서 모든 ” 1 . 0 " 을 " 1 . 1 " 로 교체 한다 . 

• mainwindow.cpp 에서 저 작권년도를 1999 - 2000 로 교체 한다 . 

(물론 판번호와 저작권년도는 실제 응용프로그람에서 const 혹은 #define 일수 있다 .) 

완료하면 lupdate 을 실행하고 Qt Linguist 에서 tt3_pt.ts 을 연다 . 다음의 항목들은 
특별한 흥미를 가진다 . 

• MainWindow 

Troll Print 1.0 - 낡은것을 의미하는 ’’(obs .)” 로 표식된다 . 

About Troll Print 1.0 -낡은것을 의미하는 "(obs .)" 로 표식된다 . 

Troll Print 1.0. Copyright 1999 Macroshaft, Inc. -낡은것을 의미하는 
”(obs .)" 로 표식된다 . 

Troll Print 1.1 - "Troll Imprimir 1.1 " 로 자동번역된다 . 

About Troll Print 1.1 - "Troll Imprimir 14 산로 자동번역된다 . 

Troll Print 1.1. Copyright 1999-2000 Macroshaft, Inc. - "Troll Imprimir 
1.1. Copyright 1999-2000 Macroshaft, Inc." 로 자동번역된다 . 

• PrintPanel 

2-sided -낡은것을 의미하는 "(obs .)” 로 표식된다 . 

<b>TROLL PRINT</b> - 표식되지 않는다 . 즉 번역되지 않는다 . 

Two-sided - 표식되지 않는다 . 즉 번역되지 않는다 . 

lupdate 가 수정을 더 간단히 하기 위하여 배경에서 힘들게 작업한다는것을 알아두시오 . 

MainWindow 안의 번역문들로 가서 그것들을 Done 으로 표식한다 . ”<b>TROLL 
PRINT</b >" 를 "<b>TROLL IMPRIMIR</b >’， 로 번역 한다 . "Two-sided " 를 번역하 
고있을 때 Guess Again 단추를 찰칵하여 "Two-sided " 를 번역하지만 ”2 " 를 ” Dois ” 로 
번역 한다 . 

보관 및 완료한 다음 lrelease 를 실행한다 . 뽀르뚜갈어판이 다음과 같이 표시된다 . 
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그림 2-14. 실례 3, "Troll Imprimir 1.1", 뽀르뚜갈판 
AjudaISobre , ( Help ᅵ About ) 를 선택 하여 판정보대화칸을 본다. 



그림 2-15. 실례 3, About box, 뽀르뚜갈판 

AjudaISobreQt , (Help ᅵ About Qt ) 을 선택 한다면 영 문대 화칸을 엄 는다. 아차! Qt 
자체로 번역할 필요가 있다 (《Qt 일반지식》7장 1절을 참고). 

그러 면 LANG=en 로 설정 하여 원래 의 영 문판을 얻 는다. 

— !□! x| 

File Help _ 


TROLL PRINT 

C Enabled (• iDisabledi 


P Enabled 우 Disabled 


그림 2-16. 실례 3, "Troll Print 1.1", 영문판 
실례들에서 번역용의 Qt 응용프로그람을 준비하기 위하여 알아두어 야 할 모든것을 설명하였다. 
프로젝트의 시작에서 프로젝트과일에 사용하려는 번역원천파일들을 추가하고 
makefile 에 lupdate 와 lrelease 에로의 호출을 추가한다. 

프로젝트에서 프로그람작성자가 수행하는 모든것은 trO 호출에서 사용자에게 보이는 본 
문의 일부분을 가리운다. 또한 같은 문맥에서 같은 본문이 두개의 다른 형식으로 번역되는 
경우에 번역기가 질문할 때 2인수형식의 Ctrl 지름건을 사용해야 한다. 또한 프로그람작성자 
는 TRANSLATION 주석을 포함하여 번역기가 응용프로그람을 항행하는데 도움을 준다. 
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제 3 장 . Qt Assistant 


이 장에서는 직결문서를 표시하는 도구인 Qt Assistant 를 소개한다. 또한 Qt 
Assistant 를 사용하여 혹은 웨브열람기로 호출할수 있는 Qt 참고문서를 소개한다. 

제 1 절 . Qt 참고문서에 대한 소개 

Qt 서 고용문서 는 개 발자들에 의하여 xpp 파일들에 직 접 씌 여 진다. 문서 림 은 문서 를 
교정하여 그것 이 정 확하고 사용할수 있게 높은 질을 담보하도록 한다. 또한 문서 림 은 클 
라스가 사용하는 개념，클라스가 제공하는 함수와 속성들을 소개하는 더 큰 본문을 작성 
한다. 

문서는 그 내부보다도 API 에 초점 을 둔다. API 가 매 개 판에서 일관성있고 호환성 
있게 유지하도록 큰 품을 들이지만 내부를 상당히 변경하여 성능을 개선하고 기능을 강 
화할수 있다. 

Qt 참고문서 는 약 1,500개 의 HTML 폐 지 (2, 500이 상의 인쇄 페 지 )로 이루어 진다. 그 
대부분의 폐지는 Qt 콜라스들을 서술한다. 개발자들은 사고방식과 작업방법이 서로 다르 
므로 문서 모임 을 항행하는 몇 가지 수법 을 제 공한다. 

• 모든 콜라스페지는 어의 공개 API 안의 각 콜라스를 서술하며 수백개의 콜라스들 
로 이루어진다. 

• 기본콜라스페지는 제 일 흔히 사용하는 콜라스들을 서술하며 모든 콜라스목록보다 
훨씬 더 간단히 더 취급하기 쉬운 목록을 제공한다. 

• 클라스그롭폐지는 매개 그룹이 관련된 클라스들의 목록으로 이루어지는 그롭목록 
을 제 시한다. 실례 로 고급한 창문부품목록을 들수 있다. 

• 계승도폐지는 Qt 들라스들의 계층도로 클라스들의 목록을 제시한다. 

• 모든 함수폐 지 는 Qt 들라스에 의해 제 공된 모든 함수들을 목록화한다. 매 개 함수 
는 그것이 있는 들라스들과 련결된다. 

Qt 문서의 탐색에는 문제가 없으며 포괄적인 교차참고를 찾을수 있다. 실례코드의 
단편에 선택가능한 련결이 포함되여도 실례로 코드실례에서 클라스선언을 우연히 만난다 
면 클라스이름은 그 클라스의 문서에 대한 선택가능한 련결로 될수 있다. 

들라스문서와 함께 일부 Qt 모둘은 대 량적 으로 서술되 여있다. Qt 서 고의 각종 견해 를 
서 술하는 개 괄문서 가 많으며 이 것 들은 모두 참고문서 의 홈폐 지 로부터 련결되 여있 다. 또 
한 Qt 배포물의 examples 보조등록부에는 두개의 련습지도서와 많은 량의 실례 프로그람 
들이 있다. 
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제 2 절. Qt Assistant 사용법에 대한 소개 

Windows 에서 Qt Assistant 는 Qt 차림 표에 서 차림 표선택 으로 사용할수 있 다. Unix 
에서는 xterm 으로부터 assistant 를 실행한다. 

Qt Assistant 를 기동할 때에는 차림표띠와 도구띠가 있는 표준기본창문형식의 응용 
프로그람이 주어 진다. 그 아래 왼쪽측면에 있는것 이 가름띠 ( Sidebar ) 라고 부르는 항행 
창문이고 오른쪽에 대부분의 공간을 차지하는것이 문서창문이다. 기정으로 Qt 참고문서 
의 홈폐지는 문서창문에 표시된다. 

Qt Assistant 는 웨 브열 람기와 비슷한 방법으로 작업 한다. 밑줄있는 본문(교차참고 
를 의미 한다)을 선택 하면 문서창문이 련관된 페지를 제시 한다. 특별히 흥미있는 폐지들 
에 서 표를 만들수 있 으며 Previous 과 Next 도구띠단추를 찰칵하여 방문하려 는 폐 지 들로 
이행할수 있다. 

Qt Assistant 가 Qt 문서 모임 을 항행 하기 위 하여 웨 브열 람기 처 럼 쓰이 지 만 Qt 
Assistant 는 웨 브열 람기 가 제 공하지 못하는 강력 한 항행수단을 제 공한다. Qt Assistant 
는 문서모임의 모든 폐지들을 색 인화하는데 지능알고리듬을 리용함으로써 특별한 단어와 
구들을 탐색할수 있다. 

색인검색을 수행하려면 Sidebar 의 Index 타브를 선택한다. (또는 Ctrl+I 를 누른 
다. ) Look For 행 편집칸에 단어 를 입 력 한다. 실례 로 homedirpatii 를 들수 있다. 입 력시 
에 단어들이 검색되고 행편집칸아래의 목록에 강조표시된다. 강조표시된 본문이 검색하 
려는것과 일 치 하면 그것 을 두번 련속 찰칵한다. (또는 Enter 를 누른다.) 이때 문서 창문 
에는 련관된 폐지가 현시된다. 드문히 Qt Assistant 가 일치하는것을 검색하기전에 전체 
단어를 입력해야 한다. 일부 단어들에 대해서는 련관된 폐지가 하나이상 있을수 있다. 

Qt Assistant 는 또한 문서 에서 특정 한 단어 를 찾기 위 한 완전본문검색 을 제 공한다. 
검색하고있는 단어의 출현률이 제일 높은 문서를 먼저 표시하며 문서에서 단어가 출현할 
때마다 강조표시된다. 

Qt Assistant 는 문서집 합인 프로파일을 창조하여 전용화할수 있다. 프로파일은 자 
기가 사용하기 위하여 혹은 배포하는 응용프로그람용으로 창조할수 있다. 프로파일을 리 
용하여 요구하는 문서를 선택하고 응용프로그람의 말단사용자가 보게 할수 있다. 
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제 3 절 . Qt Assistant 의 세부 


File Edit View Go Bookmarks Help 

!♦ * »| 日 " a 리理 is 니 ，끼 — 

i 선 

O QSProject Class 1 (J] 

Consents | Index | Bookmarks | Search | 

void QSProject :: addSignalHandler ( QObject • sender, 」 

const char * signal, QObject * receiver, 
const char A qtscriptFunction) 

Adds the Qt Script function qtscriptFunction in the context of receiver as a 
signal handler for the C++ signal signal of the object sender. 

Example: | 

project->addCignalHandler ( m^Button, CIGNAL( clicksd 
() 》, document, "startCalculation" ); 

See also removeSiqnalHandlerO. 

| add Signal Handler 

A Complete Application Window ᅬ 

A Scriptable Spreadsheet 

activeEditor 

addCode 

add Function 
addObject 
addObjectFactory 

addTransie ntObject 
addTransientSignalHandler 
add Wrap perFacto ry 

call Zi 

void QSProject::addSignalHandler( QObject * sender, 
const char * signal, const char • qtscriptFunction) 

Adds the Qt Script function qtscriptFunction (fully qualified) as a signal handler ，| 


A 


그림 3-1. Qt Assistant 


1. 가름띠 (Sidebar) 


=j x| 

Contents | Index J Bookmarks | Search | 

+ m Qt Script for Applications 
+ |[Q Qt Script for Applications Reference ... 

+ Qt Script: Language Reference 


그림 3-2. 가름띠 

가름띠 는 문서 를 항행하는 4가지 방법 을 제 공한다. 

① Contents 타브는 유효문서모임의 나무보기를 표시한다. 항목을 하나 누르면 그 
문서가 문서창문에 나타난다. 항목을 두번 련속 누르거나 항목왼쪽의 +기호를 선택하면 
항목의 보조항목들이 나타난다. 보조항목을 하나 누르면 문서창문에 그 폐지가 나타난다. 
항목왼쪽의 -부호를 선택하여 그 보조항목을 숨긴다. 
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② Index 타브는 열 쇠단어 혹은 구들을 검 색 하는데 리 용된 다 (2 절 을 참고) . 

③ Bookmarks 타브는 자기가 만든 서표들을 표시한다. 서표를 하나 두번 련속 누 
르면 문서창문에 그 폐지 가 나타난다. Bookmarks 타브는 아래 에 New Bookmark 단추와 
Delete Bookmark 단추를 가지고있다. New Bookmark 를 선택하여 문서창문에 보여주 
고있는 폐지에 서표를 추가한다. 목록에서 서표를 하나 선택하고 Delete Bookmark 를 
눌러 강조표시된 서표를 삭제한다. 

④ Search 타브는 모든 문서의 완전본문검색을 제공한다 (4 절 참고). 

문서창문이 될수록 더 많은 공간을 차지하게 하려면 가름띠를 간단히 숨기거나 표 
시할수 있다. 가름띠가 표시되여있으면 Ctrl + T , Ctrl + I 를 누르고 숨기려면 Ctrl+B 혹은 
Ctrl + S 를 누른다. 가름띠가 숨겨져있으면 Ctrl + T 를 눌러서 Contents 타브에 표시하거 
나 또는 Ctrl + I 를 눌러서 Index 타브에 그것을 표시 하거 나 (Look For 행 편집 칸에 초점 이 
놓인다) 혹은 Ctrl + B 를 눌러서 Bookmarks 타브에 표시하고 또는 Ctrl + S 를 눌러서 (완 
전본문) Search 타브에 표시할수 있다. 

가름띠 는 류동가능창문이 므로 Qt Assistant 창문의 상하좌우로 끌고가거 나 Qt 
Assistant 밖에 끌고가서 그것이 떠오르게 할수 있 다. 


2. 문서창문 

[겊 QSProject Class 


改 


make an object available this way even though it is not made 

available as atoplevel object, is so that code can be added in the 
context of that object. 

Objects added with this function are made persistent. This means 
that when the interpreter is cleared, either by calling 
QSInterpreter::clearfi or by modifying the scripts, these objects 


will still be made available to the scripting engine. 


그림 3-3. 문서창문 

문서창문은 표시하는 각 문서 에 대 하여 타브작성 을 허 용함으로써 문서표시 기 능을 
제공한다. Add Tab 단추를 누르면 새 타브가 타브의 제목으로서 폐지이름과 함께 나타 
난다. 이것은 여러개의 각이한 문서들과 작업하고있을 때 폐지들사이를 절환할수 있게 
한다. 문서창문의 오른폭에 있는 Close Tab 단추를 찰칵하여 타브를 삭제 할수 있다. 


3. 도구띠 

I 奉 » 껸육육1 비 

그림 3-4. 도구띠 
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도구띠는 가장 일반적으로 사용하는 작용들을 고속으로 호출할수 있게 한다. 

• Previous 는 이전 페지를 펼치게 한다. 차림표선택은 Go | Previous 이고 지름건 
은 Alt+Left Arrow 이 다. 

• Next 는 다음 폐지를 펼치게 한다. 차림표선택은 GolNext 이고 지름건은 
Alt+Right Arrow 이 다. 

• Home 은 홈폐지(보통 Qt 참고문서의 홈폐지)를 펼치게 한다. 차림표선택은 
Go | Home , 지름건은 Ctrl+Home 이다. 

• Copy 는 선택된 본문을 오려둠판에 복사한다. 차림표선택은 Edit | Copy 이고 지 
름건은 Ctrl+C 이 다. 

• Find in Text 는 Find Text 대화칸을 펼친다. 차림표선택은 Edit | Find in Text 
이고 지름건은 Ctrl+F 이 다. 

• Print 는 Print 대화칸을 펼친다. 차림표선택은 File|Print 이고 지름건은 Ctrl+P 이다. 

• Zoom in 는 서체 크기를 증가시 킨다. 차림표선택은 View | Zoom in 이고 지름건은 
Ctrl ++ 이 다 . 

• Zoom out 는 서체 크기를 감소시킨다. 차림표선택은 View | Zoom out 이고 지름건 
은 Ctrl — 이다. 

• What’s This ? 는 Qt Assistant 특성의 서술을 제공한다. 차림표선택은 

Help | What’s This ? 이고 지름건은 Shift+Fl 이다. 

나머 지 도구띠단추들은 서 표이 며 구성 환경 에 따라 달라진 다. 

4. 차림표 

1) File 차림표 

• File | Print 는 Print 대화칸을 펼친다. 

• File | Exit 는 Qt Assistant 를 완료한다. 

2) Edit 차림표 

• Edit | Copy 는 선택된 본문을 오려둠판에 복사한다. 

• Edit | Find in Text 는 Find Text 대화칸을 호출한다. 

• Edit | Settings 은 Settings 대화칸을 펼친 다. 

3) View 차림표 

• View | Zoom in 은 서 체 크기 를 증가시 킨 다. 

• View | Zoom out 는 서 체 크기 를 감소시 킨 다. 

• View | Views | Sidebar 는 가름띠의 표시를 절환한다. 

• View | Views | Toolbar 는 도구띠의 표시를 절 환한다. 

• View | Views | Line up 는 도구띠 의 도구띠 단추들을 정 렬 한다. 
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4) Go 차림표 

• Go | Previous 는 이 전 폐지를 현시 한다. 

• Go | Next 는 다음 페지를 현시한다. 

• Go | home 은 홈페 지로 간다. 

또한 이 차림표는 추가적인 항목들을 가지고있다. 이것들은 환경구성에 따라 달라 
지는 미 리 정의된 서표들이다. 

5) Bookmarks 차림표 

Bookmarks | Add 는 서 표목록에 현재 페 지 를 추가한다. 

이 차림표는 추가항목들 즉 이미 만든 서표들을 가지고있다. 서표를 삭제하려면 가 
름띠의 Bookmarks 타브로 이행한다. 

5. 대화칸 

1) Print 대화칸 

이 대화칸은 가동환경에 고유하다. 이것은 각종 인쇄기선택에 대한 호출을 주며 현 
재 폐지를 인쇄하는데 쓰일수 있다. 

2) Find Text 대화칸 

이 대화칸은 현재 폐지에서 본문을 찾는데 리용된다. Find 행편집칸에 찾으러는 본 
문을 입 력 한다. Whole words only 검사칸을 설정 하면 람색은 오직 완전히 일치하는 단 
어들을 검색한다. 즉 이 검사칸을 설정하고 spin 을 검색한다면 spinbox 는 찾지 않지만 
spin 은 찾는다. Case sensitive 검사칸을 설정 하면 실례 로 spin 은 Spin 과는 대조되지 않 
는다. Direction 라지오선택중 하나를 선택하여 폐지안의 현재위치로부터 정방향으로 
( Forward ) 또는 역방향으로 ( Backward ) 검색할수 있다. Find 단추를 찰칵하여 검색하 
고(혹은 다시 검색한다) Close 단추를 찰칵하여 완료한다. 

3) Settings 대화칸 

Settings 대화칸은 Qt Assistant 를 자기의 요구에 맞게 설정하는데 리용된다. 대화 
칸에는 4개의 타브 즉 General Settings , Web Settings , PDF Settings 그리고 
Profiles 가 있 다. Qt Assistant 는 창문크기 와 위 치 , 열 려 진 폐 지 들을 비 롯하여 쎄 손들사 
이의 환경설정을 기억한다. 매개 타브는 다음에 설명한다. 

• General 설정 
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그림 3-5. General 설정 

Qt Assistant 에서 사용한 기준서체를 변경하려면 Font 복합칸에서 서체형을 선택한 
다. 새로운 고정폭의 서체를 선택하려면 실례로 코드부분을 표시하려면 Fixed font 복합 
칸에서 서체형을 선택 한다. 초본문련결색을 변경하려면 Link color 색단추를 찰칵한다. 
밑줄있는 련결을 바라지 않는다면 Underline links 검사칸의 설정을 해제한다. 

• Web 설정 



그림 3-6. Web 설정 

일부 폐지들에는 외부웨브페지들에 대한 련결이 들어있다. 이 련결들을 현시하려면 웨 
브열람기를 지정해야 한다. Web Browser Application 행편집칸에서 열람기의 실행가능파 
일의 이름을 입력한다. 또는 생략단추를 찰칵하여 Set Web Browser 대화칸을 펼치고 사용 
하려는 웨브열람기를 찾을 때까지 항행한다. Save 를 선택하여 선택을 받아들인다. 

Qt Assistant 의 기정홈패지를 변경하려면 Home Page 행편집 칸에 파일이름을 입력 
한다. 또는 생 략단추를 찰칵하여 Set Homepage 대화칸을 연다. 사용하려는 홈폐지파일 
을 찾을 때까지 항행하고 Save 를 눌러서 선택을 받아들인다. 
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• PDF 설정 



그림 3-7. PDF 설정 

일부 폐지들은 PDF 문서에 대한 련결을 포함한다. 이 련결을 현시하려면 PDF 보기 
프로그람을 지정 해 야 한다. 행 편집칸에서 PDF 보기 프로그람의 실행 파일 이름을 입 력 한다. 
또는 생 략단추를 찰칵하여 Set PDF Browser 대화칸을 열고 사용하려는 PDF 보기프로 
그람을 찾을 때까지 항행한다. Save 를 선택하여 선택을 받아들인다. 
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절. 완전본문검색 



그림 3-8. 완전본문탐색 

istant 는 강력한 완전본문탐색엔진을 제 공한다. 어 1 
1타브를 선택한다. 그다음 검 색하려 는 본문을 입호 
-칵한다. 검색은 대소문자를 구별하지 않으므로 Fc 
인로 취급된다. 다음은 일반탐색패턴의 실례들이다. 

- 단어 deep 를 포함하는 문서들을 모두 렬거한다. 

— deep 로 시 작하는 단어를 포함하는 문서들을 모 
opy — deep 와 copy 를 둘다 포함하는 문서들을 모 
: opy " — 구 deep copy 를 포함하는 모든 문서들을 
1(*) 는 인용표안에서 사용할수 없다. 

문서목록은 문서들이 포함하는 탐색본문의 출현회ᄂ 
4 제일 큰것이 우선 나타난다. 목록에서 임의의 근 




변경되였으면 즉 문서가 추가 또는 삭제되였으면 Qt As 











제 5 절 . Qt Assistant 으 I 전용화 

Qt Assistant 는 문서모임으로부터 문서를 추가하고 삭제하여 전용화할수 있다. 또 
한 Qt Assistant 는 프로파일선택을 받아들이는데 이것은 그 속성을 변경할수 있게 한다. 
실례 로 기정시 작폐지와 응용프로그람그림 기 호를 들수 있다. 

1. 기정문서모임의 수정 

선택없이 시 작할 때 Qt Assistant 는 문서의 기정 모임 을 현시 한다. Qt 가 설치될 때 
Qt Assistant 안의 기정문서모임은 Qt Designer 와 qmake 와 같이 Qt 와 함께 제공되는 
도구들은 물론이고 Qt 참고문서를 포함한다. 

문서 는 내 용파일 을 추가, 삭제 함으로써 Qt Assistant 로부터 추가 혹은 삭제 할수 있 
다. 내용파일의 형식은 아래에 지정한다. 내용파일을 추가하려면 다음의 지령행선택 즉 
-addContentFile docfile 을 입 력 한다. 기정 모임 에서 내 용파일을 삭제 하려 면 다음의 지 령 행선 
택 즉 -removeContentFile docfile 을 입 력 한다. 실례 로 

1: > assistant -addContentFile file.dcf 

2: > assistant 

3: > assistant -removeContentFile file.dcf 

1 행에서는 file.dcf 를 추가한다. 2행에서는 Qt Assistant 를 기동한다. 이제는 기정모 
임이 doc 파일 file.dcf 로 확장된다. 3행에서는 기정문서모임에서 파일 file.dcf 을 삭제함으 
로써 그후에 Qt Assistant 를 사용할 때 이 파일을 포함하지 않게 한다. 

-문서내용파일형식 

문서내 용파일 은 문서 의 내 용표와 색 인용의 모든 중요열 쇠단어 들을 포함해 야 한다. 
또한 Qt Assistant 도구띠에 현시 되는 문서 용그림 기호를 계승할수 있다. 또한 문서에서 
리용된 추가화상들의 여분의 등록부경로를 지정해야 한다. 

모든 유효꼬리표와 속성들을 사용하는 내용파일의 실례를 아래에 보여준다. 

<assistantconfig version ="3.2.0"> 

<DCF ref = M demo . html n icon =" handbook . png ” imagedir ="../ img/ n 
title="Development Demo Handbook ’’〉 

〈section ref= M ./chap 1 /chap 1 title="Chapterl M > 

<section ref="./chap 1/ sectionl . html " title =" Sectionl "> 

〈keyword ref= M ./chap 1 /section 1 . html # foo M > foo </ keyword > 

〈keyword ref= M ./chap 1 /section 1 . html # bla "> bla </ keyword > 

〈section ref =” ./chap 1 /section 1 . html#subsection 1 ’’ title =” Subsection 1 ’ V 〉 

<section ref= M ./chap 1 /section 1 . html # subsection 2" title="Subsection 2"/> 
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<section ref =" ./chap 1 /section 1 . html # subsection 3" title= M Subsection 3"/〉 

</ section > 

〈section ref= M ./chap 1 / section 2" title =,, Section 2"> 

〈section ref =” ./chap 1 / section 2 . html#subsection 1" title =" Subsection 1 "/〉 

<section ref= M ./chap 1 / section 2. html # subsection 2" title= M Subsection 2 M /> 

<section ref = M ./ chapl / section 2. html # subsection 3" title= M Subsection 3"/〉 

</ section > 

</ section > 

〈section ref = M ./ chap 2/ chap 2. html " title = M Chapter 2"> 

〈keyword ref= M ./ chap 2/ chap 2 . html # foo M > foo </ keyword > 

〈section ref =’’./ chap 2/ sectionl . html ’’ title = M SectionrV > 

</ section > 

</ DCF > 

</ assistantconfig > 

절은 필요한만큼 깊이 겹쌓을수 있다. 모든 참고는 련결되여 야 한다. 

주어 진 절을 위한 keyword 꼬리 표는 그 절안에 놓인 다른 절보다 앞에 있어 야 한다. 
refs 속성안의 경 로들은 항상 Unix 형 식(전방의 사선들)으로 씌여지며 문서내 용파일 
자체와 련관된다. 

Qt 3. 2.0 판으로부터 파일형 식 에서 새 로운 뿌리꼬리 표 assistantconfig 의 도입 으로 한개 
파일 에서 여 러 개의 DCF 꼬리 표를 지정할수 있게 되 였다. Qt 3. 2까지 사용한 낡은 문서 
내용파일형식은 여전히 유효하다. 


2. 프로파일 

프로파일은 Qt Assistant 가 응용프로그람의 문서를 표시 하기 위 한 전문화된 방조도 
구로서 동작하게 한다. 프로파일을 리 용하여 문서의 저 자는 Qt Assistant 의 제목，응용 
프로그람그림기호，판정보대화칸와 같은 속성들을 변경할수 있다. 또한 프로파일들은 
Qt doc 로부터 분리되는 전문화된 문서모임을 실행 하는데 리용될수 있다. Qt Assistant 
는 다음의 속성들을 변경하여 전용화할수 있다. 

• 이름 - 이 속성은 프로파일을 이름짓는데 사용된다. 다중프로과일을 Qt 
Assistant 의 같은 설치에 사용한다면 이 파라메터는 프로파일에 고유한 환경설정을 따 
로 보관하는것 이 중요하다. 속성 이 름은 name 이 다. 

• 제목 - 이 속성은 Qt Assistant 용의 제목을 지정하는데 쓰인다. 속성이름은 title 이다. 

• 응용프로그람그림 기 호 - 이 속성 은 Qt Assistant 응용프로그람그림 기 호로서 사용 
될 그림기호를 서술한다. 그림기호의 위 치는 프로파일의 위 치와 련관되 여있다. 속성이름 
은 applicationicon 이 다. 
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• 시작페지 一 이 속성은 프로파일을 사용할 때 Qt Assistant 가 처음에 어느 페지를 
표시 하는가를 지정 한다. 보통 이것은 문서의 내용표를 포함하는 HTML 파일 이다. 또한 
이 속성은 Qt Assistant 의 기본사용자대면부에서 홈단추를 누를 때 가야 할 기정위치를 
서술한다. 시작폐지는 프로파일의 위 치와 련관되여 지정된다. 속성이름은 startpage 이 다. 

•판정보차림표본문 - 이 속성은 Help 차림표에 나타나는 본문 실례로 About 
Application 을 서 술한다. 속성 이 름은 aboutmenutext 이 다. 

• URL 정보 - 이 속성은 Help 차림표에서 열려지는 About 대화칸 실례로 About 
Application 의 내용을 서술하는 HTML 파일을 지적하는데 사용될수 있다. url 은 프로 
파일의 위 치와 련관되 여 지정된다. 속성이름은 abouturl 이 다. 

• Qt Assistant 문서 - 이 속성은 Qt Assistant 문서의 위치를 서술한다. 이것은 Qt 
Assistant 가 완전본문검 색 방조와 Help 차림 표의 Qt Assistant Manual 선택 과 같은 자체 
의 방조를 제공하기때문에 요구된다. 위 치는 프로파일의 위 치와 련관한 등록부이다. 속 
성 이 름은 assistantdocs 이 다. 

프로파일을 정의하기 위하여서는 보통 .adp 로 생략된 Qt Assistant 문서프로파일을 
지정해 야 한다. 프로파일은 우에서 서 술한 문서내 용파일의 확장이다. 형 식 으로 property 
꼬리 표들을 포함하는 profile 꼬리 표를 추가한다. 

문서프로파일의 실례 는 다음과 같다. 

helpdemo.adp 

<assistantconfig version =’’3 .2.0’’> 

< profile > 

〈property name =" name n > HelpExample </ property > 

〈property name = M title n >Help Example </ property > 

〈property name =" applicationicon n > logo . png </ property > 

〈property name = n startpage n > index . html </ property > 

〈property name =" aboutmenutext">About Help </ property > 

〈property name =" abouturr >../ about . txt </ property > 

〈property name =’’ assistantdocs ">../../. ./ doc / html </ property > 

</ profile > 


<DCF re 卜" index . html ’’ icon =" handbook . png M title="Help example "> 
〈section ref = n ./ manual . html " title= M How to use this Example ’’〉 
〈keyword ref ="./ manual . html # installdocs">Install Docs </ keyword > 
〈keyword ref = M ./ manual . html # onlydoc n >Example Profile </ keyword > 
〈keyword ref= M ./ manual . html # hide">Hide Sidebar </ keyword > 
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〈keyword ref = M ./ manual . html # openqabutton M > Open </ keyword > 

〈keyword ref =" ./manual . html # closeqabutton M > Close </ keyword > 

〈keyword ref = M ./ manual . html # display n > Display </ keyword > 

</ section > 

</ DCF > 

</ assistantconfig > 

이 파일들은 XML 파일 이다. <，>，그리고 &와 갈은 문자들은 실체로서 씌 여져야 
한다. (실 례 로 & lt ;, & gt ;, & amp ;). 

프로파일의 사용 

프로파일을 리 용하려 면 선택 -profile filename 으로 Qt Assistant 를 실행한다. 이것은 
파일에 지정된 프로파일을 적재하고 Qt Assistant 를 전용화한다. 실례로 Qt Assistant 
를 우의 실례파일 helpdemo.adp 를 리용하여 실행하려면 다음과 같이 지령을 실행한다. 

> assistant -profile helpdemo.adp 

Qt Assistant 에 의 하여 자기 응용프로그람들에서 프로파일을 사용하는 방법을 보여 
주는 HelpDemo 실례를 Qt 배포물로부터 참고하시오. 
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제 4 장. qmake 


qmake 는 각이한 콤과일러들과 가동환경용의 makefile 을 작성하기 위하여 
Trolltech 가 개발한 도구이 다. 

수동적 인 makefile 작성은 복잡하여 오유를 범하기 쉬우며 특히 각이한 콤파일러들 
과 가동환경을 결합하여 여러개의 makefile 들을 만들 때는 특히 더 복잡하다. 개발자들 
은 qmake 를 리용하여 간단한 하나의 프로젝트파일을 만들고 qmake 를 실행 하여 적 당한 
makefile 들을 생성한다. qmake 는 콤파일러와 가동환경의 의존관계들을 모두 고려하여 
개발자들이 마음놓고 자기 코드작성에만 집중할수 있게 한다. Trolltech 는 Qt 서고와 그 
와 함께 제공된 도구들에서 기본건설도구로서 qmake 를 사용한다. 

qmake 는 또한 moc 와 uic 의 건설규칙들을 자동적으로 포함하여 Qt 의 특수한 요구 
를 만족시 킨다. 

제 1 절 . qmake 설치 

1. qmake 설치 

qmake 는 Qt 가 건설될 때 기정으로 건설된다. 

이 절에서는 qmake 를 수동적으로 건설하는 방법을 설명한다. 이미 qmake 를 가지 
고있으면 2절로 넘어갈수 있다. 

- qmake 의 수동설치 

Qt 를 수동적으로 설치하기전에 다음과 같은 환경변수들을 설정해야 한다. 

• QMAKESPEC 

QMAKESPEC 는 체계에서 사용하고있는 가동환경과 틈파일러결합에 따라서 설정 
되여야 한다. 실례로 Windows 와 Microsoft Visual Studio 를 사용하고있다면 이 환경 
변수를 win 32_ msvc 로 설정하여야 한다. Solaris 와 g ++ 를 사용한다면 이 환경변수를 
solaris - g ++ 로 설정 하여 야 한다. 

다음은 QMAKESPEC 를 설정할 때 선택할수 있는 환경 변수들을 보여 준다. 

aix -64 hpux-cc irix -032 netbsd - g ++ solaris-cc unixware 7- g ++ aix - g ++ hpux-g++ linux-cxx 
openbsd - g ++ solaris - g ++ win 32 -borland aix-xlc hpux - n 64 linux - g ++ openunix-cc sunos-g-H- wi 
n 32- g ++ bsdi - g ++ hpux - o 64 linux-icc qnx-g++ tru 64 -cxx win 32 -msvc dgux - g ++ hurd - g ++ linu 
x-kcc reliant -64 tru 64 -g++ win 32 -watc freebsd-g++ irix -64 macx-pbuilder reliant-cds ultrix - g + H - 
win 32 -visa hpux-acc irix - g ++ macx - g ++ sco - g ++ unixware-g hpux-acc irix - n 32 solaris -64 uni 
xware 7 -cc 
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환경 변수는 qws/enwar 로 설정 되 여 야 하며 여 기서 enwar 는 다음것들중의 하나이 다. 
linux-arm-g++ linux-generic-g++ linux-mips-g++ linux-x86-g++ linux-freebsd-g++ linux-ipa 
q-g++ linux-solaris-g++ qnx-rtp-g++ 

•QTDIR 

QTDIR 는 어가 설치될 곳으로 설정되여야 한다. 실례로 c:\qt 와 \local\qt 
환경변수들이 일 단 설정 되 면 qmake 등록부 $QTDIR/qmake, 실례 로 C:\qt\qmake 로 들어 
간다. 그리 고 자기 의 를파일 러 에 따라서 make 혹은 nmake 를 실 행한다. 
make 가 끝나면 qmake 를 사용할 준비가 끝난다. 

제2절. qmake 사용법에 대한 소개 

1. 프로젝트파일의 작성 

qmake 는 프로젝트파일 (.pro) 들에 보관된 정보를 리용하여 그것 이 생성 하는 
makefile 들에 포함해야 할것을 결정한다. 

기본 프로젝트 파일은 응용 프로 그람에 대한 정보 례를 들면 응용 프로 그람을 름파일하 
는데 요구되는 파일들과 사용하려는 환경설정을 포함한다. 

여기에 프로젝트파일의 간단한 실례가 있다. 

SOURCES = hello.cpp 
HEADERS = hello.h 
CONFIG qt wam_on release 
한행 씩 간단히 설 명한다. 

SOURCES = hello.cpp 

이 행은 응용프로그람을 실현하는 원천파일들을 지정한다. 이 경우에는 한개 파일 
hello.cpp 만 있다. 대다수 응용프로그람들은 여러 파일들을 요구하므로 이러한 경우에 
는 다음과 같이 한 행우에 공백으로 구분하여 모두 목록하는 방법으로 처리한다. 
SOURCES = hello.cpp main.cpp 

그렇지 않으면 매 개의 파일을 다음과 같이 행 을 바꾸어 개 별적 인 행 들에 배 치할수 
었 다‘;. 

SOURCES = hello.cpp \ 
main.cpp 

좀 장황한 방법 은 다음과 같이 매 개 파일 을 따로따로 배 치하는것 이 다. 

SOURCES += hello.cpp 
SOURCES += main.cpp 

이 수법 에서는 =보다도 +=를 사용하여 현존목록을 교체하지 않고 항상 새 파일을 
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안전하게 추가한다. 

HEADERS 행 은 응용프로그람에서 사용하기 위하여 생성한 머 리부파일을 지정하는 
데 쓰인다. 실례로 

HEADERS += hello.h 

원천파일들을 목록하는 임의의 수법을 머리부파일들에 사용할수 있다. 

CONFIG 행은 응용프로그람의 환경구성 에 대 한 qmake 정보를 주는데 사용된다. 
CONFIG ^ fer-qt wam_on release 

여 기서는 이미 존재하는 환경선택들에 새 로운 선택 을 추가해 야 하므로 +=를 사용한 
다. 이것 은 모든 선택 을 새 로 주어 진 선택 들과 완전히 교체하는 =를 사용하는 경 우보다 
안전 하다. 

CONFIG 행의 qt 부분은 qmake 에게 어를 사용하여 응용프로그람을 건설하고있다는 
것을 알린다. 이것은 qmake 가 련결시에 Qt 서고들과 련결하며 를파일에 요구되는 머리 
부경 로들을 포함시 킨다는것 을 의 미한다. 

CONFIG 행의 warn_on 부분은 qmake 에게 경고가 출력되도록 콤파일러기발을 설 
정해야 한다는것을 알린다. 

CONFIG 행의 release 부분은 qmake 에게 응용프로그람을 출하판으로 건설해야 한 
다는것을 알린다. 개발시에 프로그람작성자들은 release 를 debug 와 교체하기를 더 좋 
아한다. 이에 대해서는 후에 론의한다. 

프로젝트 파일들은 일반본문 (즉 notepad, vim 혹은 xemacs 와 같은 편집기를 사 
용)이고 .pro 확장자로 보관되여야 한다. 실행가능 프로 그람의 이름은 프로젝트 파일이름 
과 같아지지만 가동환경에 따라 적당한 확장자가 주어진다. 실례로 hello.pro 라는 프로 
젝트 파일은 Windows 에서는 hello, exe, 政 nix 에서는 hello 를 생성 한다. 


2. makefile 의 생성 

프로젝트파일을 작성한 다음에는 makefile 을 간단히 생성할수 있으며 작성자는 프 
로젝트파일을 작성한 위치로 가서 다음과 같이 입력한다. 

즉 makefile 들은 다음과 같이 .pro 파일들로부터 생성된다. 
qmake -o Makefile hello.pro 

Visual Studio 사용자인 경우에 qmake 는 또한 .dsp 파일들을 생성할수 있다. 실례로 
qmake -t vcapp -o hello.dsp hello.pro 
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제 3 절. qmake 련습 

이 련습에서는 qmake 사용법을 설명 한다. 

1. 간단히 시작하기 

자기 응용프로그람의 기본실현을 방금 끝내고 다음과 갈은 파일들을 창조하였다고 
가정하자. 

•hello.cpp 

■hello.h 

•main.cpp 

qt/qmake/examples/tutorial 에서 이 파일들을 찾을수 있다. 응용프로그람의 설 
치에 대하여 한가지 알아야 할것은 그것이 Qt 로 씌여지는것이다. 우선 자기가 좋아하는 
일반본문편집기를 리용하여 qt/qmake/tutorial 에서 hello.pro 라는 파일을 창조한다. 
처음에 해야 할 일은 qmake 에게 자기의 개발프로젝트의 부분인 원천파일과 머리부파일 
들에 대 하여 알리는 행들을 추가하는것 이 다. 

우선 프로젝트 파일에 원천파일들을 추가한다. 그러자면 SOURCES 변수를 사용해야 
한다. SOURCES +=로 새 행을 시작하고 그 뒤에 hello.cpp 를 넣는다. 즉 
SOURCES += hello.cpp 

프로젝트안의 매개 원천파일에 대하여 다음행들로 끝날 때까지 이것을 반복한다. 
SOURCES += hello.cpp 
SOURCES += main.cpp 

make 형의 문법을 사용하기 좋아한다면 다음과 같이 새행확장기호를 리용하여 모든 
파일을 한번에 렬거할수 있다. 

SOURCES = hello.cpp \ 
main.cpp 

이제는 프로젝트 안에 원천파일들이 렬거되 여있으므로 머 리부파일들을 추가해 야 한 
다. 원천파일들과 갈은 방법으로 머리부파일들을 정확히 추가한다. 하지만 변수이름은 
HEADERS 이다. 

이 것을 수행한 다음 자기 프로젝트 파일은 다음과 같아야 한다. 

HEADERS += hello.h 
SOURCES += hello.cpp 
SOURCES += main.cpp 

목표이름은 자동적으로 설정되고 프로젝트 파일과 같지만 가동환경에 적합 한 뒤붙이 
가 있 다. 실례로 프로젝트 파일을 ’hello.pro ’라고 부른다면 목표는 Windows 에서 
’hello.exe’, Unix 에서 ’hello ’ 로 된다. 다른 이름을 사용하려면 그것을 프로젝트 파일 
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에서 설정할수 있다 

TARGET = helioworld 

마지막 단계는 CONFIG 변수의 설정이다. 이것이 Qt 응용프로그람이므로 CONFIG 
행에 ’qt’ 를 넣음으로써 qmake 가 련결해야 할 관련서고들을 추가하게 하여 makefile 에 
moc 와 uic 용의 건설행들이 포함된다는것을 담보한다. 

완료된 프로젝트파일은 다음과 같다. 

CONFIG += qt 
HEADERS += hello 上 
SOURCES += hello.cpp 
SOURCES += main.cpp 

이제는 qmake 를 사용하여 자기 응용프로그람을 위 한 makefile 을 생성할수 있다. 
지 령 행 에서 자기 응용프로그람등록부안에 서 다음과 같이 입 력 한다. 
qmake -o Makefile hello.pro 

그다음 사용하는 를파일러 에 따라 make 혹은 nmake 라고 입 력 한다. 

2. 응용프로그람을 오유수정가능하게 하기 

응용프로그람의 출하판은 오유수정기 호나 다른 오유수정정 보를 포함하지 않는다. 
개 발시 에 관련정 보를 가지는 응용프로그람의 오유수정 판을 생성하는것 이 좋다. 이것 은 
프로젝트 파일안의 CONFIG 변수에 ’debug’ 를 추가하여 간단히 달성된다. 

실례로 

CONFIG 建，: qt debug 
HEADERS += hello.h 
SOURCES += hello.cpp 
SOURCES += main.cpp 

makefile 을 생성하기전에 qmake 를 사용하여 자기 응용프로그람을 오유수정가능하 
게 할수 있다. 

3. 가동환경에 고유한 원천파일들의 추가 

몇시간 코드작성한 후에 자기 응용프로그람의 가동환경에 고유한 코드부분을 만들 
어 가동환경에 의존하는 코드를 분리하여 만들려고 결심할수 있다. 그러면 자기의 프로 
젝트파일에 포함해야 할 파일이 두개로 된다. 즉 hellowin. cpp 와 hellounix. cpp 를 
들수 있다. SOURCES 변수에 이것들을 추가하면 makefile 에 두 파일이 0 모두 넣어지므 
로 그렇게 할수 없다. 그러므로 여기서 할 일은 qmake 를 실행 하는 가동환경 에 따라서 
처 리되는 유효범위 를 리 용하는것 이 다. 

Windows 용의 가동환경에 의존하는 파일에 추가해야 할 간단한 유효범위는 다음과 
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갈다. 


Win32 { 

SOURCES += hellowin.cpp 

} 

그러므로 qmake 를 Windows 에서 실행한다면 원천파일목록에 hellowin.cpp 가 추 
가된다. qmake 를 다른 가동환경 에서 실행한다면 단지 그것을 무시한다. 이제 남은 일은 
unix 의존파일용의 유효범위를 창조하는것 이 다. 

그것을 수행하였을 때 자기의 프로젝트 파일은 다음과 갈아야 한다. 

CONFIG += qt debug 
HEADERS += hello.h 
SOURCES += hello.cpp 
SOURCES += mainxpp 
Win32 { 

SOURCES += hellowinxpp 

} 

unix { 

SOURCES += hellounix.cpp 

} 

makefile 을 생성하기전에 qmake 를 사용하여 야 한다. 

4. 파일이 존재하지 않으면 qmake 를 중지하기 

어떤 파일이 존재 하지 않으면 makefile 을 창조하지 않으려 고 할수 있 다. exists () 
함수에 의하여 파일이 있는가 검사할수 있다. errorO 함수를 사용함으로써 qmake 의 처 
리를 중지시킬수 있다. 이것은 유효범위와 같은 수법으로 작업한다. 단순히 유효범위조 
건을 함수로 바꾸면 된다. main , cpp 파일의 검사는 다음과 같다. 

! exists ( main . cpp ) { 
error ( "No main.cpp file found " ) 

} 

! 는 본문을 부정 하는데 쓰인 다. 즉 exists ( main . cpp ) 는 파일 이 존재 하면 참이 
고 ! exists ( main . cpp ) 은 파일 이 존재 하지 않으면 참이 다. 

CONFIG += qt debug 
HEADERS += hello.h 
SOURCES += hello.cpp 
SOURCES += main.cpp 
Win32 { 
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SOURCES += hellowin.cpp 

} 

unix { 

SOURCES += hellounixxpp 

} 

!exists( main.cpp ) { 
error( "No main.cpp file found" ) 

} 

makefile 을 생성하기전에 qmake 를 사용하여야 한다. 일시적으로 main . cpp 의 이 
름을 변경한다면 통보문을 보게 되며 Qmake 는 처리를 중지한다. 

5. 하나이상의 조건검사 

Windows 를 사용하며 지령행에서 자기의 응용프로그람을 실행할 때 qDebugO 명 
령문을 볼수있게 하려고 한다고 가정한다. console 설정하여 자기의 응용프로그람을 건 
설하지 않으면 출력을 볼수 없다. CONFIG 행에 간단히 console 을 넣음으로써 
Windows 에서 makefile 이 이러한 설정을 가지게 할수 있다. 그러나 Windows 에서 실 
행하고있는 조건에서 debug 가 이미 CONFIG 행에 있을 때 CONFIG 행만 추가하려고 
한다고 하자. 이것은 두개의 겹쌓인 유효범위를 사용할것을 요구한다. 즉 하나의 유효범 
위 를 창조하고 그안에 다른것을 창조한다. 마지 막 유효범위안에 처 리 하려는 설정 내 용을 
다음과 같이 넣는다. 

Win32 { 
debug { 

CONFIG += console 

} 

} 

겹쌓인 유효범위들은 두점을 사용하여 모두 결합할수 있으므로 최종의 프로젝트파 
일은 다음과 같아진다. 

CONFIG 寒 ， qt debug 

HEADERS += hello.h 

SOURCES += hello.cpp 

SOURCES += main.cpp 

Win32 { 

SOURCES: 寒參 hellowin.cpp 

} 

unix { 
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SOURCES += hellounix.cpp 


! exists ( main.cpp ) { 
error ( "No main.cpp file found " ) 

} 

Win32 :debug { 

CONFIG += console 

} 

이로써 qmake 에 대한 련습을 끝마친다. 이제는 자기의 개발프로젝트의 프로젝트파 
일을 쓸 준비가 되였다. 

제4절. qmake 에서 사용하는 용어들 

qmake 는 각이 한 가동환경들에서 사용할 개발프로젝트용 makefile 들을 창조하기 위 
하여 Trolltech 에서 제공하는 사용하기 편리한 도구이 다. qmake 는 불과 몇행의 정 보로 
makefile 을 창조할수 있게 함으로써 makefile 들의 생성을 단순화한다. qmake 는 (과로 
작성하거나 작성하지 않는 임의의 쏘프트웨어프로젝트에 쓰일수 있지만 Qt 개발을 지원 
하기 위 한 추가적 인 기능을 포함하고있다. 

qmake 는 프로젝트파일안의 정보에 기초하여 makefile 을 창조한다. 프로젝트파일 
들은 개 발자에 의해 창조된다. 프로젝트파일들은 보통 단순하지만 필요하다면 아주 복잡 
해질수 있다. qmake 는 또한 프로젝트파일을 변경하지 않고도 Microsoft Visual studio 
용프로젝트들을 생성 할수 있다. 

1. qmake 의 기본용어 

1) QMAKESPEC 환경변수 

qmake 를 makefile 건설에 사용하기전에 QMAKESPEC 환경변수를 체계에 사용되 
고있는 가동환경-름파일러결합으로 설정해야 한다. QMAKESPEC 환경변수는 가동환경 
과 를파일러에 고유한 정보를 어디서 찾아야 하는가를 qmake 에게 말한다. 이것은 정확 
한 서고를 사용한다는것과 생성된 makefile 이 정확한 문법을 사용한다는것을 담보한다. 
현재 유지된 가동환경-름파일러결합의 목록은 qt/mkspecs 에서 찾아볼수 있다. 자기의 
환경변수를 렬거한 등록부들중 하나로 설정한다. 

실례로 Windows 에서 Microsoft Visual Studio 를 사용하고 있다면 
QMAKESPEC 환경변수를 win32_msvc 로 설정한다. Solaris 에서 gcc 를 사용하고있다 
면 자기 의 QMAKESPEC 환경 변수를 solaris_g++ 로 설정한다. 
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qt/mkspecs 안의 매개 등록부에는 가동환경과 름파일러에 고유한 정보를 포함하는 
qmake.conf 파일이 있 다. 이 설정들은 qmake 에 의 해 건설되는 프로젝트에 적용되며 
자기가 전문가가 아닌 이상 수정하지 말아야 한다. 실례로 모든 응용프로그람들이 특정 
서고에 련결해야 한다면 이 정보를 련관된 qmake.conf 파일에 추가할수 있다. 

2) 프로젝트 (.pro) 파일들 

프로젝트 파일은 응용 프로 그람의 makefile 을 창조하는것과 련관된 자세한 정보를 
qmake 에게 알리는데 사용된다. 실례로 프로젝트 파일에 넣 어야 할 원천파일과 머리부파 
일들의 목록，련결되여야 할 특수한 서고와 같은 응용 프로 그람에 고유한 환경구성, 혹은 
특수한 머리부경로이다. 

- #설명문 

프로젝트파일에 설명문을 추가할수 있다. 설명문은 #기호로 시작하며 행끝까지 실 
행 한다. 

3) 형판 

형판변수는 qmake 에게 응용프로그람에 어떤 종류의 makefile 이 생성되여야 하는 
가를 알린다. 다음의 선택이 가능하다. 

•app- 응용프로그람을 건설하는 makefile 을 창조한다. 이것은 기정이므로 형판이 
지정되지 않으면 이것이 사용된다. 

• lib - 서고를 건설하는 makefile 을 창조한다. 

• vcapp - 응용프로그람을 건설하는 Visual Studio 프로젝트파일을 창조한다. 

• vclib - 서고를 건설 하는 Visual Studio 프로젝트파일을 창조한다. 

• subdirs - 이것은 지정된 등록부에 들어가는 makefile 을 창조하는 특수한 형판로 
서 그 프로젝트파일의 makefile 을 창조하고 그것 에 대 하여 make 를 호출한다. 

- app 형 판 

app 형판는 qmake 에 응용프로그람을 건설하는 makefile 을 생성할것을 알린다. 이 
형판을 리용할 때 다음의 qmake 체계변수들이 인식된다. 자기의 .pro 파일에서 이것들을 
사용하여 자기의 응용프로그람에 대한 정보를 지정해야 한다. 

• HEADERS - 응용프로그람의 모든 머리 부파일들의 목록. 

• SOURCES - 응용프로그람의 모든 원천파일들의 목록. 

• FORMS - 응용프로그람의 모든 .ui 파일들 (Qt Designer 에 의 해 창조된것) 의 목록. 

• LEXSOURCES - 응용프로그람의 모든 lex 원천파일들의 목록. 

• YACCSOURCES - 응용프로그람의 모든 yacc 원천파일들의 목록. 

• TARGET - 응용프로그람의 실행 파일 이 름. 기정 으로 이것은 프로젝 트파일 이 름이 
다. (확장자는 자동적으로 추가된다.) 

• DESTDIR - 실행가능한 목표가 배치되는 등록부. 
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• DEFINES - 응용프로그람에 필요한 앞처리정의들의 목록. 

• INCLUDEPATH - 응용프로그람에 필요한 추가적인 머리부경로들의 목록. 

• DEPENDPATH - 응용프로그람의 의존관계 람색경로. 

• VPATH - 공급된 파일들을 찾기 위 한 탐색 경 로. 

• DEF_FILE - Windows 만: 응용프로그람에 련결하려는 .def 파일. 

• RC_FILE - Windows 만: 응용프로그람의 자원파일 . 

• RES_FILE - Windows 만: 응용프로그람에 련결하려는 자원파일. 

오직 값을 가지는 체계변수들만 사용할 필요가 있다. 실례로 특수한 
INCLUDEPATH 들을 가지지 않는다면 아무것도 지정할 필요가 없으며 qmake 는 기정 
으로 필요한것 을 추가한다. 실례 로 실례 프로젝트 파일은 다음과 갈을수 있다. 

TEMPLATE = app 

DESTDIR @ d:\helloapp 

HEADERS f«r' ： hello.h 

SOURCES += hello.cpp 

SOURCES += main.cpp 

DEFINES += QTDLL 

CONFIG ； ♦= qt wam_on release 

하나의 값을 가지는 항목들 실례로 형판 또는 목적등록부에 대하여 =를 사용하지만 
여러값을 가지는 항목들에 대해서는 +=를 사용하여 그 형의 현존항목들에 추가한다. =를 
사용하면 항목의 값이 새 값으로 교체되고 실례로 DEFINES=QT_DLL 라고 썼으면 다른 
모든 정의가 삭제된다. 

- lib 형판 

1 比)형판는 qmake 에게 서고를 건설 하는 makefile 을 생성 하도록 한다. 이 형판을 리 
용할 때 app 형판에 대하여 우에서 언급한 체계변수와 함께 VERSION 변수가 유지된다. 
자기의 .pro 파일에서 이것들을 사용하여 서고에 대한 정보를 지정해야 한다. 

• VERSION - 목표서고의 판번호，실례로 2.3.1. 

- subdirs 형 판 

subdirs 형판는 qmake 에게 지정된 보조등록부안에 들어갈 makefile 을 생성하고 그 등록 
부안에 프로젝트 파일의 makefile 을 생성하고 그것에 대하여 make 를 호출해게 한다. 

이 형판용으로 인식되는 유일한 체계변수는 SUBDIRS 변수이다. 이 변수는 처리하 
려는 모든 보조등록부들의 목록을 포함한다. qmake 가 프로젝트파일을 찾을수 있도록 보 
조등록부안의 프로젝트파일이 보조등록부와 같은 이름을 가지게 하는것 이 본질이다. 실 
례로 보조등록부가 myapp 라면 그 등록부안의 프로젝트파일은 그 등록부안에서 
myapp.pro 로 불리워 야 한다. 
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4) CONFIG 변수 

config 변수는 롬파일 러 가 사용하여 야 할 선택 들과 련결해 야 할 서 고들을 지 정한다. 
임의의것을 config 변수에 추가할수 있으나 아래 에 준 선택들은 qmake 에 의 하여 내부적 
으로 인식된다. 

다음의 선택들은 어떤 름파일러선택을 사용하는가를 조종한다. 

• release - 응용프로그람을 출하방식으로 건설한다. 이것은 debug 가 지정되면 무 
시된 다. 

• debug - 응용프로그람을 오유수정 방식 으로 건설 한다. 

• warn_on - 름파일러는 될수록 많은 경고를 출력해야 한다. 이것은 warn_off 가 
지정되면 무시된다. 

• warn_off - 콤파일 러는 될수록 적은 경 고를 출력 해 야 한다. 

다음의 선택은 건설하려는 서고나 응용프로그람의 형을 정의한다. 

•qt - 응용프로그람은 Qt 응용프로그람이고 Qt 서고에 련결되 여 야 한다. 

• thread - 응용프로그람은 다중스레 드응용프로그람이 다. 

•xll - 응용프로그람은 XII 응용프로그람 혹은 서 고이다. 

• windows - app 형 판만: 응용프로그람은 Windows 창문응용프로그람이 다. 

• console - app 형 판만: 응용프로그람은 Windows 콘솔응용프로그람이 다. 

•dll - lib 형판만: 서고는 공유서고 (dll) 이다. 

• static lib - 1 比)형판만: 서고는 정적서 고이 다. 

• plugin - lib 형판만: 서고는 플라그인이며 이것은 dll 선택을 가능하게 한다. 
실례로 자기의 응용프로그람이 Qt 서고를 사용하고 그것을 오유수정가능한 다중스레드 

응용프로그람으로 건설하려 고 한다면 자기의 프로젝트파일은 다음과 같은 행 을 가전다. 
CONFIG += qt thread debug 

= 가 아니라 +=를 사용해야 하며 qmake 는 어를 건설하는데 사용한 설정을 어떤 형 
의 Qt 서고가 건설되였는가 하는 차림표로서 사용할수 없다. 

2. 연산자 

지 금까지 는 프로젝 트파일 에서 사용되 고있는 =연산자와 += 연산자를 보았다. 사용할 
수 있는 연산자들은 더 있으나 그 일부는 기대한것보다 더 변경할 때에는 조심히 사용해 
야 한다. 

■겨 연산자 

이 연산자는 단순히 변수에 값을 대 입하며 다음과 같이 사용된다. 

TARGET = myapp 

이것은 TARGET 변수를 myapp 로 설정한다. 이것은 이전에 설정된 TARGET 를 
삭제 한다. 
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(受)， +=연산자 

이 연산자는 변수의 값목록에 값을 추가한다. 이것은 다음과 같이 사용된다. 
DEFINES += QTDLL 

이것은 makefile 에 넣어지는 앞처 리정의의 목록에 QT_DLL 를 추가한다. 

資) ᅳ=연산자 

이 연산자는 변수안의 값목록에서 값을 삭제한다. 그것은 다음과 같이 사용된다. 
DEFINES -= QT DLL 

이것은 makefile 에 넣어지는 앞처 리정의의 목록에서 QT_DLL 을 삭제한다. 

④ *= 연산자 

이 연산자는 변수안의 값목록에 어떤 값이 존재하지 않으면 그것을 추가한다. 그것 
은 다음과 같이 사용된다. 

DEFINES *= QT DLL 

QT_DLL 은 앞처리정의들의 목록에 그것이 없는 경우에만 추가된다. 

⑤ ᆻ=연산자 

이 연산자는 regexp 와 일치하는 값들을 지정된 값으로 교체한다. 이것은 다음과 
같이 사용된다. 

DEFINES ~= s/QT_[DT].+/QT 

이것은 QT 가 있는 QT_D 혹은 QT_T 로 시작하는 목록안의 값들을 삭제한다 . 

3. 유효범위 

유효범위는 ’if ’명령문과 비슷하다. 즉 일정한 조건이 참이면 유효범위안에서 설정 
내용이 처리된다. 유효범위는 다음과 같이 쓸수 있다. 

Win32 { 

DEFINES 닭 QT—DLL 

} 

우의 코드는 qmake 가 Windows 가동환경 에서 사용된다면 makefile 에 QT_DLL 정 
의를 추가한다. qmake 가 Windows 가 아닌 다른 가동환경에서 사용된다면 그 정의는 
무시된다. 또한 다음과 같이 qmake 에 의 하여 한행의 대 입을 수행 할수도 있다. 

Win32 :DEFINESj«* QTDLL 

실례로 Windows 를 제외한 모든 가동환경에서 무엇인가 처리하려고 한다고 가정하 
자. 다음과 같이 유효범 위 를 부정하여 이것 을 달성할수 있다. 

! Win32 { 

DEFINES += QT_DLL 

} 

CONFIG 행의 항목도 유효범위이다. 실례로 다음과 같이 쓴다면 
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CONFIG •本 wam_on 

warn_on 라는 유효범위를 가질것 이다. 이것은 특정한 환경구성 에 필요되는 전용환 
경설정을 모두 잃지 않고 하나의 프로젝트에 대한 환경구성을 간단히 변경하게 한다. 
CONFIG 행에 자체의 값들을 넣을수 있으므로 이것은 자기의 makefile 들에 아주 강력한 
환경구성을 제공한다. 실례로 

CONFIG 寒 qt wam_on debug 
debug { 

TARGET = myappdebug 

} 

release { 

TARGET = myapp 

} 

우의 코드에서 두개 리용범위가 CONFIG 행 에 무엇 이 넣어지는가에 따라 창조된다. 
실례에서 debug 는 config 행우에 있으므로 TARGET 변수가 myappdebug 로 설정된다. 
release 가 config 행우에 있으면 TARGET 변수가 myapp 로 설정된다. 

또한 일부 설정을 처리하기전에 두가지를 검사하는것이 가능하다. 실례로 가동환경 
이 Windows 이고 스레드환경이 설정되는가 검사하려고 한다면 다음과 같이 쓰군 한다. 
Win32 { 
thread { 

DEFINES += QTTHREADSUPPORT 

} 

} 

겹 쌓인 많은 유효범 위 를 간단히 쓰러 면 다음과 같이 두점 을 리용하여 유효범 위 들을 
겹쌓을수 있다. 

Win32 :thread { 

DEFINES . QT THREAD SUPPORT 

} 

일단 시험을 하였다면 또한 else/elseif 조작을 수행할수도 있다. 이와 함께 복잡한 
시험을 간단히 쓸수 있다. 이것은 특별한 else 유효범위를 가지고 수행될수 있으며 우와 
같이 두점으로 분리하여 다른 유효범위들과 결합될수 있다. 실례로 
Win32 :thread { 

DEFINES m QT THREAD SUPPORT 
} else:debug { 

DEFINES QT NOTHREAD DEBUG 
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message("Unknown configuration") 

} 

4. 변수 

지 금까지 보아온 변수들은 DEFINES, SOURCES, HEADERS 와 같은 체 계변수들 
이 다. 자체 의 변수들을 창조하여 유효범 위안에 서 그것 들을 사용할수 있 다. 자체 의 변수 
를 창조하는것은 간단하다. 변수의 이름을 지정하고 거기에 무엇인가 할당한다. 실례로 
MYVARIABLE = value 

자체의 변수들에 무엇을 수행하여야 하는가에 대한 제한은 없다. qmake 는 어떤 유 
효범위에 대하여 변수들을 고찰할 필요가 없으면 무시한다. 

변수이름앞에 $$를 놓음으로써 다른 변수에 현재 변수의 값을 할당할수 있다. 실례로 
MYDEFINES = $$DEFINES 

그러 면 MY_DEFINES 변수는 프로젝 트파일안에서 현재 DEFINES 변수에 있는것 을 
포함한다. 이것은 또한 다음과 등가하다. 

MY_DEFINES = $$ {DEFINES} 

둘째 표기 는 공백 으로 구분함이 없 이 변수를 다른 값으로 전개할수 있게 한다. 
qmake 는 변수가 임 의 의 것 (Makefile 로 직 접 교체 되 는 $ (VALUE) 등) 을 포함하게 하 
며 적 당히 보통 환경 변수로서 전개하게 한다. 그러 나 환경 변수를 곧 교체할것 을 요구한 
다면 $$() 표기를 사용할수 있다. 실례로 
MYDEFINES = $$(ENY_DEFINES) 

이것은 .pro 파일을 해석할 때 MY_DEFINES 를 환경변수 ENV_DEFINES 의 값으 
로 설정한다. 추가적으로 교체하고있는 변수에서 기본함수를 호출할수 있다. 이 함수들 
(다음에 렬거 하는것 처 럼 시 험함수들과 혼돈하지 말아야 한다. )을 아래 에 렬거 한다. 

: 資 ) join ( variablename, glue, before, after ) 

이것은 variablename 의 값을 glue 와 결합한다. 이 값이 비지 않았으면 값을 
before 의 앞에，그리 고 after 의 뒤 에 둔다. variablename 는 유일 하게 필요되는 마당이 
고 다른것들의 기정값은 빈 문자렬 이 다. glue, before 혹은 after 안의 공백들을 부호화 
하여야 한다면 그것들을 인용해야 한다. 

② prompt ( question ) 

이것은 question 을 현시하고 stdin 으로부터 돌림값으로서 읽어들인다. 

: 遠 ) member( variablename, position ) 

이것은 목록의 posi 仕 on 위치에 있는 variablename 에 값을 배치한다. variablename 
의 값이 길지 않으면 이것은 빈 문자렬을 돌려준다. variablename 은 유일하게 요구되는 
마당이다. 위치가 지정되지 않으면 목록안의 첫값 (0) 으로 기정설정된다. 
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④ find( variablename, substr ) 

이것은 variablename 안에서 substr 와 일치하는 값들을 모두 배렬한다. substr 는 
물론 정규식일수 있으며 따라서 대조될것 이 다. 

MY VAR = one two three four 

MY_VAR2 = $$join(MY_VAR, ” -L", -L) -Lfive 

MY_VAR3 = $$member(MY_VAR, 2) $$fmd(MY_VAR, t.*) 

MY_VAR2 는 ’-Lone -Ltwo -Lthree -Lfour - Lfive ’을 포함하며 MYVAR3 는 
J three two three’ 을 포함한다. 

⑤ system ( program_and_args ) 

이것은 실행된 프로그람의 stdout/stderr 를 돌려주며 보통 기대한대로 그 문법을 
해석한다. 이것을 리용하여 가동환경에 대한 정보를 질문할수 있다. 실례로 
UNAME = $$ system(uname - s ) 

contains( UNAME, [lL]inux ):message( This looks like Linux ($$UNAME) to me ) 

5. 시험함수 

qmake 는 단순하지 만 강력한 시험을 진행하는 기본함수들을 제공한다. 이 시험은 
우에서 서술한것처럼 유효범위의 위치에서 사용될수 있으며 일부 경우에는 시험값을 무 
시 하고 자체 의 시 험함수를 사용하는것 이 좋다. 

' 建 ). contains ( variablename, value ) 

value 가 variablename 라는 변수에 보관한 값목록에 있으면 유효범위안의 환경설 
정들이 처리된다. 실례로 

contains( CONFIG, thread) { 

DEFINES += QTTHREADSUPPORT 

} 

thread 가 CONFIG 변수용값목록에 있으면 QT_THREAD_SUPPORT 가 

DEFINES 변수안의 값목록에 추가된다. 

② count ( variablename, number ) 

number 가 variablename 라는 변수에 보관된 값들의 수와 일 치 하면 유효범 위안의 
환경설정들이 처리된다. 실례로 
count( DEFINES, 5 ) { 

CONFIG += debug 

} 

遠 ) .error( string ) 

이 함수는 주어진 문자렬을 출력하고 qmake 를 완료시킨다. 실례로 
error ( "An error has occured" ) 
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본문 "An error has occured” 이 콘솔에 현시되고 qmake 는 완료된다. 

④ exists ( filename ) 

지정된 파일 이 존재 하면 유효범위안의 환경설정들이 처 리된다. 실례 로 
exists( /local/qt/qmake/main, cpp ) { 

SOURCES += main, cpp 

} 

/local/qt/qmake/main.cpp 이 존재하면 main.cpp 가 원천파일목록에 추가된다. 
’’/"가 가동환경에 관계없이 등록부분리기호로서 사용될수 있다는것을 알아두시오. 

⑤ equals ( variable, value ) 

지정된 변수가 넘긴 값과 같다면 그 유효범위가 처리된다. 실례로 
NUMBERS = 12 3 
equals( NUMBERS, 3 4 5 ) { 

message ("The numbers are equal") 

} 

"1 2 3” 이 "3 4 5” 와 같지 않으므로 통보문이 현시되지 않는다. 모든 함수들에서와 
같이 값인수로서 전개된 변수를 넘길수 있다. (즉 $$NUMBERS). 

⑥ include ( filename ) 

filename 의 내용은 이 시점에서 프로젝트파일에 포함되므로 지정된 파일안의 환경 
설정들이 처리된다. 이 실례는 다음과 갈다. 
include ( myotherapp. pro ) 

myo 比 lerapp.pro 프로젝트파일안의 설정들이 지금 처리된다. 

⑦ isEmpty( variablename ) 

이것은 count( variablename, 0 ) 의 사용과 등가하다. variablename 라는 변수가 
요소를 가지지 않으면 유효범위안의 환경설정들이 처 리된다. 실례 로 
isEmpty( CONFIG ) { 

CONFIG += qt warn_on debug 

} 

⑧ message ( string ) 

이 함수는 단순히 콘솔에 통보문을 출력 한다. 
message ( "This is a message" ) 

본문 ” This is a message’’ 이 콘솔에 출력되고 프로젝트파일의 처리가 수행된다. 

® system ( command ) 

지정된 지령이 수행되여 완료코드 1을 돌려주면 유효범위안의 환경설정들이 처리된 
다. 실례로 
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system ( Is /bin ) { 

SOURCES += bin/main, cpp 
HEADERS += bin/main.h 

} 

그러므로 지령 Is /bin 이 1 을 돌려주면 bin/main.cpp 가 원천목록에 추가되고 
bin/main.h 가 머리부목록에 추가된다. 

⑩ infile( filename, var, val ) 

이 함수는 파일 filename (qmake 자체에 의해 해석될 때)이 값 val 을 가지는 변수 
var 를 포함한다면 성공한다. 또한 제 3 인수 (val) 를 넘기지 않을수도 있으며 함수는 var 
가 파일에서 할당되였는가만 검사한다. 

제5절. 사전번역된 머리부의 사용 

사전틈파일된 머 리부들은 안전한 코드본체를 름파일하고 코드의 름파일된 상태를 2 
진파일에 보관할 목적으로 일부 콤파일러들에 유지된 기능이다. 다음에 를파일할 때 름 
파일러는 보관된 상태를 적재하고 지정된 파일의 름파일을 계속한다. 다음에 름파일할 
때 안전한 코드가 재름파일을 요구하지 않으므로 더 빨타진다. 

qmake 는 일부 가동환경에서 사전번역된 머리부 (PCH) 와 다음과 갈은 건설환경을 
지원 한다. 

- Windows 
o nmake 

公 Dsp 프로젝트 (VC 6.0) 
o Vcproj 프로젝 트 (VC 7.0 & 7.1) 

- Mac OS X 
o Makefile 
o Xcode 

o GCC 3.3 이상 

- Unix 

o GCC 3.4 이상 

1. PCH 를 자기 프로젝트에 추가 

1) 사전콤파일된 머리부파일의 내용 

사전틈파일된 머리부는 자기 프로젝트에서 완전히 안정하고 정적인 코드를 포함해 
야 한다. 전형적 인 PCH 는 다음과 같다. 
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stable.h 


/* Add C includes here */ 

#if defined _cplusplus 
/* Add C++ includes here */ 

#include <stdlib> 

#include <iostream> 

#include <vector> 

#include <qapplication.h> // Qt includes 
#include <qpushbutton.h> 

#include <qlabel.h> 

#include ’’thirdparty/include/libmain.h’’ 

#include M my_stable_class.h M 

#endif 

C 파일용사전콤파일된 머리부파일이 C++ 코드를 포함할수 없으므로 사전름파일된 머 
리 부파일 은 CPP 머 리 부로부터 C 머 리 부를 분리할것 을 요구한다. 

2) 프로젝트선택 

자기 프로젝 트가 PCH 를 사용하게 하기 위 하여 자기의 프로젝 트설정 (.pro) 에서 변 
경해 야 할 유일한것은 PRECOMPILED_HEADER 선택을 포함하는것 이 다. 
PRECOMPILED_HEADER= stable.h 

나머지는 qmake 가 조종하여 사전틈파일된 머리부파일의 창조와 사용을 담보한다. 
HEADERS 에 사전를파일된 머리부파일을 포함할 필요는 없다. 환경구성이 PCH 를 유 
지한다면 qmake 가 이것을 수행한다. 

사전콤파일된 머리부를 유지하는 모든 가동환경은 환경선택 precompile_header 모 
임을 가전다. 이 선택을 리용하여 자기의 .pro 파일에서 조건블로크들을 삽입하여 PCH 
를 리용할 때 설정값들을 추가할수 있다. 실례로 

precompile—header: ! isEmpty(PRECOMPILED_HEADER) { 

DEFINES += USING_PCH 

} 

2. 례제프로젝트 

qt/qmake/examples/precompile 등록부에서 다음과 같은 원천 코드를 찾아볼수 있다. 

① mydialog.ui 

<!DOCTYPE UixUI version="3.3" stdsetdef="l"> 

<class>MyDialog</class> 
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<widget class="QDialog"> 

<property name=’’name’’> 

<cstring>MyDialog</cstring> 

</property> 

〈property name="caption n > 

<string>Mach 2!</string> 

</property> 

<vbox> 

<widget class="QLabel"> 

〈property name="name ’’〉 

<cstring>aLabel</cstring> 

々 property 〉 

〈property name="text M > 

<string>Join the life in the fastlane; - PCH enable your project today! -</string> 
</property> 

</widget> 

<widget class= M QPushButton M > 

〈property name="name’’> 

<cstring>aButton</cstring> 

々 property 〉 

〈property name="text"> 

<string>&amp ;Quit</string> 

〈 /property 〉 

<property name=’’accel’’> 

<string>Alt+Q</string> 

</property> 

</widget> 

</vbox> 

</widget> 

</UI> 

(D stable.h 

/* Add C includes here */ 

#if defined _cplusplus 
/* Add C++ includes here */ 
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# include <iostream> 

# include <qapplication.h> 

# include <qpushbutton.h> 

# include <qlabel.h> 

#endif 

(3) myobject.h 
#include <qobject.h> 
class My Object : public QObject 

{ 

public: 

MyObject(); 

〜 MyObject(); 

}； 

④ myobject.cpp 
#include <iostream> 

#include <qobject.h> 

#include "myobject.h n 

MyObject: : MyObject() : QObject() 

{ 

std::cout « "MyObject: : MyObject()\n"; 

} 

util.cpp 

void util_function_does_nothing() 

{ 

// Nothing here... 
int x = 0; 

++ x ; 

} 

⑤ main.cpp 

#include <qapplication.h> 

#include <qpushbutton.h> 

#include <qlabel.h> 

#include "myobject.h n 
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#include "mydialog 上" 

int main(int argc, char **argv) 

{ 

QApplication app(argc, argv); 

MyObject obj; 

MyDialog dia; 
app.setMainWidget( &dia ); 

dia.connect( dia.aButton, SIGNAL(clicked()), SLOT(close()) ); 

dia.show(); 

return app.exec(); 

} 

⑥ precompile.pro 

# Example for using Precompiled Headers 

TEMPLATE = app 
LANGUAGE = C++ 

CONFIG += console precompile header 


# Use Precompiled headers (PCH) 
PRECOMPILED_HEADER = stable.h 


HEADERS += stable.h \ 
myobject.h 

SOURCES += main.cpp \ 
myobject.cpp \ 
util.cpp 

FORMS = mydialog.ui 
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제 6 절. qmake 지령들 


이것은 교차가동환경 makefile 생성편의프로그람 qmake 에서 사용하는 모든 지령행 
선택 과 환경 구성，내 부변수들의 자세 한 색 인 이 다. 

다음에 서술하는 변수，함수들과 함께 qmake 프로젝트파일에는 주석문을 포함할수 
도 있 다. 주석 은 #기 호로 시 작하여 행 끝까지 이다. 

1. 지 령행 선택 

1) 문법 

qmake [options] files 

2) 선택 

다음의 선택들은 qmake 의 지령행에 지정될수 있다. 

-o file 

qmake 출력 은 file 에 로 진행 된다. 이 인수를 지 정 하지 않으면 qmake 는 적 당한 이 
틈으로 추측한다. ’-’가 지정되면 출력은 stdout 에로 진행된다. 

-unix 

qmake 는 unix 방식에서 실행한다. 이 방식에서 Unix 파일명명 및 경로관례를 사용 
하며 추가적으로 unix (유효범위로서)용의 시험이 계속된다. 이것은 모든 Unix 에서 기 
정 방식 이 다. 

-macx 

qmake 는 Mac OS X 방식 에 서 실 행한다. 이 방식 에 서 Unix 파일 명 명 및 경 로관례 를 
사용하며 추가적으로 macx (유효범위로서) 용의 시험이 계속된다. 이것은 Mac OS 표에 
서 기 정방식 이 다. . 

-Win32 

qmake 는 Win32 방식에서 실행한다. 이 방식에서 Windows 파일명명 및 경로관례 
를 사용하며 추가적으로 Win32 ( 유효범위로서)용의 시험이 계속된다. 이것은 Windows 
에서 기정방식이다.. 

-d 

qmake 는 쓸모있는 오유수정정 보를 출력 한다. 

-ttmpl 

qmake 는 . pro 파일이 처리된 후에 tmpl 을 가지는 TEMPLATE 변수설정을 무시한다. 

-tp prefix 

qmake 는 TEMPLATE 변수에 앞붙이를 추가한다. 

-help 
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qmake 는 이 특성들을 조사하고 쓸모있는 방조를 준다. 

또한 자기의 프로젝트파일에서 문제를 찾는데 도움을 줄수 있는 경고선택들이 있다. 

-Wall 

여 기서 qmake 는 알려 진 모든 경 고를 설정 한다. 

-Wnone 

Qmake 는 어떤 경고정보도 생성하지 않는다. 

-Wparser 

qmake 는 구문해석경고만 생성하며 이것은 자기의 .pro 파일들에서 일반적인 함정 
들과 잠재 하는 문제 들을 경 고한다. 

-Wlogic 

qmake 는 다시 일반적 인 함정 들과 잠재 하는 문제 들에 대 하여 경 고한다. 이것은 파 
일이 파일목록에 배치되는가，파일을 찾을수 없는가 등에 대한 검사를 포함할수 있다. 
그러 나 제 한은 없다. 

qmake 는 두가지 서로 다른 방식의 조작을 유지한다. 첫째 방식은 기정으로서 
makefile 생성 이 다. 이 방식 에서 qmake 는 하나의 .pro 파일을 가지며 그것을 makefile 
로 바꾼다. makefile 의 창조는 이 참고차림표서에서 설명하며 거기에는 .pro 파일들을 
생성하는 다른 방식이 있다. 

이 방식들을 절환하려면 첫 인수에 사용하려는 방식을 지정해야 한다. 방식을 지정 
하지 않으면 qmake 는 makefile 방식으로 가정한다. 쓸수 있는 방식들은 다음과 같다. 
-makefile 

qmake 출력 은 makefile (Makefile 방식 ) 이 다. 

-project 

qmake 출력 은 프로젝 트파일 (Project 파일 방식 ) 이 다. 

- Makefile 방식 

Makefile 방식에서 qmake 는 makefile 을 생성한다. 이 방식에서는 추가적으로 다음 
과 갈은 인수들을 공급할수 있다. 

-after 

qmake 는 지령행에서 지정된 파일들뒤에 주어진 인수들을 처리한다. 

-nocache 

qmake 는 . qmake.cache 파일을 무시한다. 

-nodepend 

qmake 는 의존관계정보를 생성 하지 않는다. 

-cache file 

qmake 는 file 을 캐쉬파일로서 사용하며 다른 . qmake.cache 파일을 발견하면 그것 
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을 무시한다. 

-spec spec 

qmake 는 spec 를 가동환경 롬파일러 정보에로의 경로로 사용하며 QMAKESPEC 가 
무시된다. 

files 인수는 공백으로 구분된 하나이상의 프로젝트 파일들의 목록일수 있다. 또한 여 
기서 지령행에 cimake 대입을 넘길수 있으며 그것들은 모든 파일들을 지정하기전에 처리 
된다. 실례로 

qmake -makefile -unix -o Makefile " CONFIG += test " test , pro 

그러나 자기의 변수들을 파일들이 지정된 후에 처리하려고 한다면 - after 인수를 넘 
길수 있다. 이것을 지정하면 지령행에서 - after 선택뒤의 모든 대입은 지정된 파일들이 
해석된 후까지 연기된다. 

이것은 Unix 경로이름이 있는 test . pro 로부터 Makefile 을 생성한다. 그러나 이러 
한 인수들의 대부분은 그것들이 기정일 때 필요하지 않다. 그러므로 행은 Unix 에서 다 
음과 같이 간단화된다. 

qmake " CONFIG += test " test , pro 

Projectfile 방식 

Projectfile 방식에서 qmake 는 프로젝트파일을 생성한다. 또한 이 방식에서는 다음 
의 인수들을 제공할수 있다. 

-r 

qmake 는 공급된 등록부들을 재귀적으로 조사한다. 

-nopwd 

qmake 는 원천코드용현재 작업 등록부를 조사하지 않고 지정된 files 만 사용한다. 

files 인수는 파일이나 등록부들의 목록일수 있다. 등록부가 지정되면 그것은 
DEPENDPATH 변수에 포함되며 그로부터 관련된 코드가 생성된 프로젝트 파일에 포함 
된다. 파일 이 주어 지 면 확장자에 따라서 정 확한 변수에 들어간다. (즉 . ui 파일들은 
FORMS 에 들어가고 .cpp 파일들은 SOURCES 에 들어간다.) 여기서 지령행에 대입을 
넘길수도 있으며 그때 이 대입들은 생성된 . pro 파일의 마감에 배치된다. 

2. 체계변수 

1) 흔히 사용하는 체계 변수들 

다음과 같은 변수들은 qmake 가 인식하며 프로젝 트파일을 창조할 때 제 일 흔히 쓰 

인다. 

CONFIG 

CONFIG 변수는 프로젝 트환경 구성 과 름파일 러 선택 들을 지 정한다. 값들은 qmake 에 
의해 내 적 으로 인식되며 특별한 의 미를 가전다. 값들은 다음과 같다. 
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다음의 CONFIG 값들은 름파일 기발들을 조종한다. 

• release - 최적화를 허용하여 롬파일한다. debug 가 지정되면 무시된다. 

• debug - 오유수정선택을 허용하여 롬파일한다. 

• warn_on - 콤파일 러는 보통보다 경 고를 더 많이 발생 해 야 한다. warn_off 가 지 
정되면 무시된다. 

• warn_off - 콤파일 러는 엄중경 고만 발생 해 야 한다. 

다음의 선택들은 응용프로그람과 서고형을 정의한다. 

•qt - 목표는 Qt 응용프로그람 및 서고로서 Qt 머 리부파일 및 서고를 요구한다. Qt 
서 고를 위한 적 당한 머 리 부와 서 고경 로들이 프로젝 트에 자동적 으로 추가된다. 

• opengl - 목표는 OpenGL (혹은 Mesa) 머 리 부와 서고들을 요구한다. 이 서고들 
을 위한 적 당한 머 리부와 서고경 로들은 프로젝트에 자동적으로 추가된다. 

• thread - 목표는 다중스레 드 응용프로그람이 나 서 고이 다. 적 당한 정 의 및 를파일 
러기발들이 프로젝트에 자동적으로 추가된다. 

• xll - 목표는 XII 응용프로그람이 나 서 고이다. 적 당한 머 리 부경 로와 서 고들이 프 
로젝트에 자동적으로 추가된다. 

• windows - 목표는 Win32 창문응용프로그람 (app 만) 이 다. 적 당한 머 리 부경 로들과 
름파일 러 기 발，서 고들이 프로젝 트에 자동적 으로 추가된 다. 

• console - 목표는 Win32 콘솔응용프로그람 (app 만) 이 다. 적 당한 머 리부경 로와 를 
파일러기발，서고들이 프로젝트에 자동적으로 추가된다. 

•dll - 목표는 공유목적파일 및 DLL 이다. 적당한 머리부경로와 름파일러기발，서 
고들이 프로젝트에 자동적으로 추가된다. 

• staticlib - 목표는 정 적 서 고 (lib 만) 이 다. 적 당한 를파일 러 기 발들이 프로젝 트에 자 
동적으로 추가된다. 

• plugin - 목표는 플라그인 (lib 만)이다. 이것은 물론 dll 을 허용한다. 

다음의 선택 들을 름파일 러 기 발들을 설 정 하는데 사용한다. 

• exceptions - 례외 유지를 허용한다. 

• rtti - RTTI 유지 를 허 용한다. 

•stl - STL 유지를 허용한다. 

다음의 선택 들은 가동환경 이 나 형 판에 따라서 특정한것 들을 정 의한다. 

• flat - vcapp 형 판을 사용할 때 이것은 모든 원천파일들을 원천그롭에 넣 으며 머 리 
부파일들은 머리부그롭에 넣는다. 이때 그것들이 상주하는 등록부는 무시한다. 이 선택 
을 해제하면 파일들이 상주하는 등록부에 따라서 원천 및 머리부그룹안의 파일들을 묶어 
놓는다. 이것은 기정으로 선택되 여있다. 

CONFIG 변수도 역시 범위를 해결할 때 검사된다. 이 변수에 아무것이나 대입할수 있다. 
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실례로 

CONFIG += qt console newstuff 


newstuff { 

SOURCES += new.cpp 
HEADERS += new.h 

} 

DEFINES 

qmake 는 이 변수의 값을 롬파일러의 C 앞처 리기 마크로 (_D 선택) 로서 추가한다. 

실례로 

DEFINES += USE MY STUFF QT DLL 
DEFFILE 

이것은 app 형판을 사용할 때 Windows 에서 사용된다. 

.def 파일 을 지 정하여 프로젝 트에 포함되 게 한다. 

DESTDIR 

목표파일 을 넣 으려 는 곳을 지 정한다. 

실례로 

DESTDIR 하 ..:,./../ lib 
DLLDESTDIR 

목표 dll 을 복사하려 는곳을 지 정한다. 

HEADERS 

프로젝 트용머 리 부파일 들을 정 의한다. 

qmake 는 지정된 머리부용의존관계정보를 생성한다. (그렇지 않으면 - nodepend 가 
지령행에 지정된다.) qmake 는 또한 moc 가 이 머리부들안의 클라스들에서 요구되는가 
를 자동적으로 탐지하고 적당한 의존관계와 파일들을 moc 파일들을 생성하여 련결하려 
는 프로젝트에 추가한다. 

실례로 

HEADERS = myclass.h \ 
login.h \ 
mainwindow.h 
또한 SOURCES 를 참고. 

INCLUDEPATH 

이 변수는 프로젝트를 름파일할 때 탐색되여야 할 # include 등록부들을 지정한다. 
등록부 분리기 호로서 :이 나 공백을 사용한다. 
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실례로 


INCLUDEPATH = c:\msdev\include d:\stl\include 
FORMS 

이 변수는 .ui 파일들 (Qt Designer 참고)을 지정 하여 롬파일하기전에 uic 에 의해 처 
리되게 한다. .ui 파일들을 건설하는데 요구되는 모든 의존관계들，머리부와 원천파일들 
이 프로젝트에 자동적으로 추가된다. 

실례로 

FORMS = mydialog.ui \ 



폼들을 뇬루 연산자로 지정 하지 말아야 한다. 그것은 이 문법 이 Qt Designer 에 의 해 
완전히 지원되지 않기때문이다. 

LEXSOURCES 

이 변수는 lex 원천파일들의 목록을 포함한다. 모든 의존관계들, 머리부와 원천파일 
들이 lex 파일을 건설할 때 프로젝트에 자동적으로 추가된다. 

실례로 

LEXSOURCES = lexer.l 

LIBS 

이 변수는 프로젝트에 련결할 서고목록을 포함한다. Unix 관례 -L/-1 기발들에 친 
숙되 여있 으면 교차가동환경방식 에 서 그 기 발들을 사용하는것 은 자유이 고 qmake 는 
Windows 에서 이 서고들을 사용하여 정확한 일을 수행한다. (즉 이것은 서고의 완전경 
로를 련결프로그람에 넘기는것을 의미한다.) 이에 대한 유일한 제한은 qmake 가 -1 lib 
가 있는 등록부를 찾을수 있도록 서고가 존재해야 한다는것 이다. 

실례 

unix:LIBS += -lmath -L/usr/local/lib 

win32:LIBS += c:\mylibs\math.lib 

MOC_DIR 

이 변수는 모든 중간의 moc 파일들이 배 치되 야 할 등록부를 지정 한다. 

실례로 

unix:MOC_DIR f= ../myproject/tmp 

Win32 :MOC_DIR = c:\myproject\tmp 

OBJECTS_DIR 

이 변수는 모든 중간의 목적파일들이 배 치되야 할 등록부를 지정한다. 

실례로 
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unix:OBJECTS_DIR = ../myproject/tmp 
win32:OBJECTS_DIR = c:\myproject\tmp 
UI_DIR 

이 변수는 uic 가 만드는 모든 중간파일들이 배치되야 할 등록부를 지정한다. 이 변 
수는 UI_SOURCES_DIR 와 UI_HEADERS_DIR 를 둘다 무시한다. 

실례로 

unix:UI_IXR: 확 ;. ,/myproject/ui 
Win32 :UI_DIR = c:\myproject\ui 
UI_HEADERS_DIR 

이 변수는 uic 가 만드는 모든 선언파일들이 배치되야 할 등록부를 지정한다. 

실례로 

unix:UI_HEADERS 一 I 가 R = . ./myproj ect/ui/include 
win32:UI_HEADERS_DIR = c:\myproject\ui\include 
UI_SOURCES_DIR 

이 변수는 uic 가 만드는 모든 실현파일들이 배치되야 할 등록부를 지정한다. 

실례로 

unix:UI_SOURCES_DIR = ../myproject/ui/src 
win32:UI_SOURCES_DIR fc:\myproject\ui\src 
REQUIRES 

이것은 qmake 가 처리하는 특수변수이다. 이 변수의 내용은 이 변수가 할당될 때 C 
ONFIG 에 없으면 어떤 의존관계들 (REQUIRES 에 할당된 값들)을 빠뜨렸는가를 서술 
하는 최소의 makefile 이 생성된다. 

이것은 주로 Qt 의 건설체계에서 실례들을 건설하는데 사용된다. 

SOURCES 

이 변수는 프로젝트안의 모든 원천파일들의 이름을 포함한다. 

실례로 

SOURCES = myclass.cpp \ 
login.cpp \ 
mainwindow.cpp 
또한 HEADERS 를 참고. 

SUBDIRS 

이 변수는 ’subdirs’ TEMPLATE 에서 사용될 때 프로젝트 파일에서 찾으러는 모 
든 보조등록부들의 이름을 포함한다. 

실례로 
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SUBDIRS = kernel \ 
tools 

TARGET 

이것은 목표파일의 이름을 지 정한다. 

실례로 

TEMPLATE = app 
TARGET = myapp 
SOURCES = main.cpp 

우의 프로젝트파일은 unix 에서 ’ myapp ’, windows 에서 ’ myapp . exe ’ 라는 이름 
의 실행 파일을 생성 한다. 

TEMPLATE 

이 변수는 프로젝 트를 생성할 때 사용하려 는 형 판이름을 포함한다. 허용값들은 다음 
과 갈다. 

•app - 응용프로그람들을 건설하기 위한 makefile 을 창조한다(기정값). 

• lib - 서 고를 건설하기 위 한 makefile 을 창조한다. 

• subdirs - 보조등록부들안의 목표들을 건설하기 위 한 makefile 을 창조한다. 

• vcapp - Win32 전용. Visual Studio 용응용프로그람 프로젝트파일을 창조한다. 

• vclib - Win32 전용. Visual Studio 용서고프로젝트파일을 창조한다. 

실례 

TEMPLATE = lib 
SOURCES = main.cpp 
TARGET = mylib 

- t 지령행선택에서 새로운 형판형을 지정하여 그 형판을 무시할수 있다. 이것은 .pro 
파일이 처리된 후에 형판형을 무시한다. 형판형을 사용하여 프로젝트건설방법을 결정하 
는 . pro 파일들에서 지령행에서 -t 선택을 사용하기보다 TEMPLATE 를 선언하는것이 
필요하다. 

YERSIOS ： 

이 변수는 ’1比’ TEMPLATE 가 지정되면 서고의 판번호를 포함한다. 

실례로 

VERSION 一 >1,.2.3 
DISTFILES 

이 변수는 dist 목표에 포함해야 할 파일목록을 포함한다. 이 기능은 UnixMake 지 
정에 의해서만 유지된다. 

실례로 
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DISTFILES += ../program, txt 

YACCSOURCES 

이 변수는 프로젝트에 포함해야 할 yacc 원천파일들의 목록을 포함한다. 모든 의존 
관계，머리부와 원천파일들은 프로젝트에 자동적으로 포함된다. 

실례로 

YACCSOURCES = moc.y 

2) 드문히 사용하는 체계변수들 

다음과 같은 변수들도 역시 qmake 가 인식하지만 내적으로 쓰이거나 아주 드문히 
쓰인다. 

DESTDIR_TARGET 

이 변수는 qmake 에 의해 내적으로 설정되며 주로 끝에 추가된 TARGET 변수를 
가지는 DESTDIR 변수이다. 이 변수의 값은 전형적으로 qmake 혹은 qmake . conf 에 
의하여 조종되 며 드문히 수정할 필요가 있 다. 

DSP_TEMPLATE 

이 변수는 qmake 에 의해 내적으로 설정되며 생성된 dsp 파일들이 기초하기 위한 
dsp 형 판이 보관되 는곳을 지 정한다. 이 변수의 값은 전형 적 으로 qmake 혹은 
qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

LEXIMPLS 

이 변수는 lex 과일들의 목록을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

LEXOBJECTS 

이 변수는 중간의 lex 목적파일들의 이름을 포함한다. 이 변수의 값은 전형적으로 
qmake 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

LITERAL_HASH 

이 변수는 변수선언에서 파일이름의 부분으로 혹은 외부응용프로그람에 넘긴 문자 
렬 안에서 상수하쉬 ( hash ) 기 호 (#) 가 요구될 때 마다 사용된다. 

실례 

# To include a literal hash character, use the $$LITERAL_HASH variable: 

urlPieces = http://doc. 仕 olltech.eom/3.3/qmake-manual-8.html LITERAL_HASH 

message($$join(urlPieces, $$LITERAL_HASH)) 

이러한 방법으로 LITERAL_HASH 를 사용함으로써 # 기호를 콘솔에 출력 하기 위 한 
message () 함수용 URL 을 구성 하는데 쓰일 수 있 다. 

MAKEFILE 

이 변수는 프로젝트건설에 대한 의존관계정보를 출력할 때 qmake 가 사용하는 
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makefile 의 이름을 지정한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 
의 하여 조종되며 드문 히 수정 할 필요가 있다. 

MAKEFILEGENERATOR 

이 변수는 makefile 을 생성할 때 사용할 makefile 생성기의 이름을 포함한다. 이 
변수의 값은 전형 적 으로 qmake 에 의 하여 조종되 며 드문히 수정 할 필요가 있 다. 

OBJECTS 

이 변수는 SOURCES 변수로부터 생성된다. 매개 원천파일의 확장자는 .o (Unix) 
혹퐁: ,obj (Win32) 로 교체된다. 이 변수의 값은 전형적으로 qmake 혹은 qmake. conf 
에 의 하여 조종되 며 드문히 수정할 필요가 있다. 

OBJMOC 

이 변수는 Q_OBJECT 마크로를 포함하는 파일들을 찾을수 있으면 qmake 에 의해 
설정된다. OBJMOC 는 모든 중간 moc 목적파일들의 이 름을 포함한다. 이 변수의 값은 전 
형 적 으로 qmake 혹은 qmake. conf 에 의 하여 조종되 며 드문히 수정 할 필요가 있 다. 

PRECOMPILEDHEADER 

이 변수는 사전를파일 된 머 리 부파일 을 창조하기 위한 머 리 부파일 을 지 적하여 프로 
젝트의 콤파일속도를 증가시킨다. 사전콤파일된 머리부들은 현재 일부 가동환경에서만 
유지 되 여있 다. (Windows - 모든 MSVC 프로젝 트형 , Mac OS X - X 코드 , Makefile, 
UNIX - gcc 3. 3이상.) 

다른 가동환경들에서 이 변수는 아래에 언급하는바와 같이 다른 의미를 가전다. 

이 변수는 사전콤파일 단계 의 정 렬 (moc 에 서 와 같이 )을 요구하는 머 리 부파일들의 목 
록을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake. conf 에 의하여 조종되 
며 드문 히 수정할 필요가 있다. 

QMAKE 

이 변수 qmake 프로그람 그자체의 이름을 포함하며 생성된 makefile 들에 배치된다. 
이 변수의 값은 전형적으로 qmake 혹은 qmake. conf 에 의 하여 조종되며 드문히 수정 
할 필요가 있다. 

QMAKESPEC 

이 변수 makefile 들을 생성할 때 사용할 qmake 환경구성의 이름을 포함한다. 이 
변수의 값은 전형 적 으로 qmake 에 의 하여 조종되 며 드문히 수정 할 필 요가 있 다. 그대 신 
에 QMAKESPEC 환경변수를 사용한다. 

QMAKEAPPFLAG 

이 변수는 ’app’ TEMPLATE 가 지정되지 않으면 비 여있다. 이 변수의 값은 전 
형 적 으로 qmake 혹은 qmake. conf 에 의 하여 조종되 며 드문히 수정 할 필요가 있 다. 그 
대 신 다음의것을 사용한다. 
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app { 

#conditional code for 'app' template here 

} 

QMAKE_APP_OR_DLL 

이 변수는 ’ app ’ 혹은 ’ dll ’ TEMPLATE 가 지정되지 않으면 비 여있다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요 
가 있다. 

QMAKEARCMD 

이것은 Unix 가동환경에서만 사용된다 

이 변수는 어카이브들을 창조하고 수정하고 꺼내는 프로그람을 호출하기 위한 지령 
을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 
드문히 수정 할 필요가 있다. 

QMAKE_CFLAGS_DEBUG 

이 변수는 오유수정방식 에 서 C 콤파일 러 용기 발들을 포함한다. 이 변수의 값은 전형 
적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE_CFLAGS_MT 

이 변수는 다중스레드응용프로그람을 창조하거나 혹은 련결하는 Qt 의 판이 다중스 
레 드 정 적련결서 고일 때 름파일 러기 발들을 포함한다. 이 변수의 값은 전형 적 으로 
qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE_CFLAGS_MT_DBG 

이 변수는 오유수정가능한 다중스레드응용프로그람을 창조하거나 련결하는 Qt 의 판 
이 오유수정가능한 다중스레드 정적련결서고일 때 름파일러기발들을 포함한다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요 
가 있다. 

QMAK 五- CFLAGS _ MT_DLL 

이것은 Windows 에서만 사용된다 

이 변수는 다중스레드 dll 을 창조하거나 련결하는 Qt 의 판이 다중스레드 dll 일 때 
의 름파일러기발들을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 
에 의 하여 조종되 며 드문히 수정할 필요가 있 다. 

QMAKE _ CFLAGS _ MT_DLLDBG 

이것은 Windows 에서만 사용된다 

이 변수는 오유수정가능한 다중스레드 dll 을 창조하거나 련결하는 Qt 의 판이 오유 
수정 가능한 다중스레 드 정 적련결서고인 경 우에 름파일 러기 발들을 포함한다. 이 변수의 
값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 
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있 다. 


QMAKE _ CFLAGS_RELEASE 

이 변수는 오유수정불가능한 응용프로그람을 창조하기 위한 름파일러기발을 포함한 
다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 
수정 할 필요가 있다. 

QMAKE _ CFLAGS_SHLIB 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 공유서고를 창조하기 위한 콤파일러기발을 포함한다 . 이 변수의 값은 
전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ CFLAGS—THREAD 

이 변수는 다중스레 드응용프로그람을 창조하기 위한 롬파일 러 기 발을 포함한다 . 이 
변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 
필요가 있다. 

QMAKE _ CFLAGS _ WARN_OFF 

이 변수는 warn_off TEMPLATE 선택이 지정되면 비지 않는다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ CFLAGS _ WARN_ON 

이 변수는 warn_on TEMPLATE 선택이 지정되면 비지 않는다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE_CLEAN 

이 변수는 moc 와 uic 가 생성한 파일이 아닌 파일들과 "make clean ” 을 사용할 때 
삭제되여야 하는 목적파일들을 포함한다. 

QMAKE _ CXXFLAGS_DEBUG 

이 변수는 오유수정 가능한 응용프로그람을 창조하기 위한 C ++ 름파일 러 기 발들을 포 
함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문 
히 수정할 필요가 있 다. 

QMAKE _ CXXFLAGS_MT 

이 변수는 다중스례 드응용프로그람을 창조하기 위 한 C ++ 를파일 러기 발들을 포함한다. 
이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 
할 필요가 있다. 

QMAKE _ CXXFLAGS _ MT_DBG 

이 변수는 오유수정 가능한 다중스레 드응용프로그람을 창조하기 위한 C ++ 콤파일 러 기 
발들을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종 
되며 드문히 수정할 필요가 있다. 
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QMAK 五 _ CXXFLAGS _ MT_DLL 

이것은 Windows 에서만 사용된다 

이 변수는 다중스레 드 dll 을 창조하기 위한 C ++ 름파일 러기 발들을 포함한다. 이 변 
수의 값은 전형적으로 qmake 혹은 qmake . conf 에 의 하여 조종되며 드문히 수정 할 필 
요가 있다. 

QMAKE _ CXXFLAGS _ MT_DLLDBG 

이것은 Windows 에서만 사용된다 

이 변수는 오유수정 가능한 다중스레 드 dll 을 창조하기 위한 C ++ 콤파일 러기 발들을 포 
함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake . conf 에 의 하여 조종되며 드문 
히 수정할 필요가 있 다. 

QMAKE _ CXXFLAGS_RELEASE 

이 변수는 응용프로그람을 창조하기 위한 C ++ 름파일 러기 발들을 포함한다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요 
가 있다. 

QMAKE _ CXXFLAGS_SHLIB 

이 변수는 공유서 고를 창조하기 위한 C ++ 름파일 러 기 발들을 포함한다. 이 변수의 값 
은 전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정 할 필요가 있 
다. 

QMAKE _ CXXFLAGS_THREAD 

이 변수는 다중스례 드응용프로그람을 창조하기 위 한 C ++ 를파일 러기 발들을 포함한다. 
이 변수의 값은 전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정 
할 필요가 있다. 

QMAKE _ CXXFLAGS _ WARN_OFF 

이 변수는 콤파일 러 경 고를 금지 하기 위한 C ++ 콤파일 러기 발들을 포함한다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요 
가 있다. 

QMAKE _ CXXFLAGS _ WARN_ON 

이 변수는 를파일 러 경 고를 생 성하기 위 한 C ++ 콤파일 러 기 발들을 포함한다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요 
가 있다. 

QMAKE _ EXTENSION_SHLIB 

이 변수는 공유서고용확장자를 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ FAILED_REQUIREMENTS 
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이 변수는 qmake 를 리 용하였을 때 부닥치 게 되 는 실패한 요구들의 목록을 포함한 
다. 실례로 sql 모둘이 요구되는데 Qt 로 를파일되지 않는다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE—FILETAGS 

이 변수는 makefile 에 입구되여야 할 SOURCES 와 HEADERS 와 같은 파일꼬리 
표들을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종 
되며 드문히 수정할 필요가 있다. 

QMAKEJNCDIR 

이 변수는 응용프로그람을 건설 할 때 INCLUDEPATH 에 추가되 여 야 할 알려 진 
모든 머리부파일들의 위치를 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

POST_TARGETDEPS 

목표가 의존하는 모든 서고들을 이 변수안에 렬거할수 있다. 일부는 이것을 유지하 
지 않는다. 여기에는 MSVCDsp 와 ProjectBuilder .pbproj 파일들이 포함된다. 일반적 
으로 이것은 건설도구들에 의해 내적으로 유지되며 의존하는 정적서고들을 명시적으로 
렬거하는데 쓸모있다. 

이 목록은 모든 기본 (및 $$ PRE _ TARGETDEPS ) 의존관계들의 다음에 놓인다. 

PRE_TARGETDEPS 

목표가 의존하는 모든 서고들을 이 변수안에 렬거할수 있다. 일부는 이것을 유지하 
지 않는다. 여기에는 MSVCDsp 와 ProjectBuilder .pbproj 파일들이 포함된다. 일반적 
으로 이것은 건설도구들에 의해 내적으로 유지되며 의존하는 정적서고들을 명시적으로 
렬거하는데 쓸모있다. 

이 목록은 모든 기본 (및 $$ PRE _ TARGETDEPS ) 의존관계들의 앞에 놓인다. 

QMAKE _ INCDIR_OPENGL 

이 변수는 OpenGL 을 유지하는 응용프로그람을 건설 할 때 INCLUDEPATH 에 추 
가되여야 할 OpenGL 머리부파일들의 위치를 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ INCDIR_QT 

이 변수는 Qt 응용프로그람을 건설 할 때 INCLUDEPATH 에 추가되 여 야 할 알려 진 
모든 머리부파일경로들의 위치를 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ INCDIR_THREAD 

이 변수는 다중스레드응용프로그람을 건설 할 때 INCLUDEPATH 에 추가되여야 
할 알려진 모든 머 리부파일경 로들의 위 치를 포함한다. 이 변수의 값은 전형 적 으로 
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qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ INCDIR _ X 11 

이것은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 XII 응용프로그람을 건설할 때 INCLUDEPATH 에 추가되여야 할 XII 
머리부파일경로의 위치를 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LFLAGS_CONSOLE 

이것은 Windows 에서만 사용된다 

이 변수는 콘솔프로그람을 건설할 때 련결기발들을 포함한다. 이 변수의 값은 전형 
적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LFLAGS _ CONSOLE_DLL 

이것은 Windows 에서만 사용된다 

이 변수는 콘솔 dll 들을 건설할 때 련결기발들을 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAK 五- LFLAGS—DEBUG 

이 변수는 오유수정가능한 응용프로그람들을 건설할 때 련결기발들을 포함한다. 이 
변수의 값은 전형 적 으로 qmake 혹은 qmake , conf 에 의 하여 조종되 며 드문히 수정 할 
필요가 있다. 

QMAKE _ LFLAGS_PLUGIN 

이 변수는 플라그인들을 건설할 때 련결기발들을 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ LFLAGS _ QT_DLL 

이 변수는 dll 로서 건설한 Qt 서고를 사용하는 프로그람들을 건설할 때 련결기발들 
을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 
드문히 수정 할 필요가 있다. 

QMAKE _ LFLAGS_RELEASE 

이 변수는 출하용응용프로그람들을 건설할 때 련결기발들을 포함한다. 이 변수의 
값은_ 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 
있 다. 

QMAKE _ LFLAGS_SHAP P 

이 변수는 ’ app ’ 형판을 사용하고있는 응용프로그람들을 건설할 때 련결기발들을 포 
함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문 
히 수정할 필요가 있 다. 

QMAKE _ LFLAGS_SHLIB 
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이 변수는 공유서고들을 건설할 때 련결기발들을 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE_LFLAGS_SONAME 

이 변수는 .so 혹은 .dll 와 갈은 공유목적파일들의 이름을 설정하기 위한 련결기 발 
들을 지정한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되 
며 드문 히 수정할 필요가 있다. 

QMAKE_LFLAGS_THREAD 

이 변수는 다중스레드프로젝트들을 건설할 때 련결기발들을 포함한다. 이 변수의 
값은 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문 히 수정 할 필요가 
있 다. 

QMAK 五 - LFLAGS—WINDOWS 

이것은 Windows 에서만 사용된다 

이 변수는 windows 프로젝트들을 건설 할 때 련결기 발들을 포함한다. 이 변수의 값 
은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문 히 수정할 필요가 있 
다. 

QMAKE_LFLAGS_WINDOWS_DLL 

이것은 Windows 에서만 사용된다 

이 변수는 windows dll 프로젝 트들을 건설 할 때 련결기 발들을 포함한다. 이 변수의 
값은 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문 히 수정 할 필요가 
있 다. 

QMAKE_LIBDIR 

이 변수는 알려진 모든 서 고등록부들의 위 치를 포함한다. 이 변수의 값은 전형 적으 
로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE_LIBDIR_FLAGS 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 - L 뒤붙이를 가지는 모든 서고등록부들의 위치를 포함한다. 이 변수의 값 
은 전형적 으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문 히 수정 할 필요가 있 
다. 

VPATH 

이 변수는 qmake 에게 열수 없는 파일들을 어디서 찾겠는가를 전한다. 이것을 리용 
하여 qmake 에게 SOURCES 와 같은것을 어디서 찾겠는가를 전달하고 SOURCES 에서 
열수 없는 항목을 찾으면 전체 VPATH 목록을 조사하여 자체로 파일을 찾는다. 

또한 DEPENDPATH 를 참고. 

DEPENDPATH 
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이 변수는 의존관계들을 해결하기 위해 조사해야 할 모든 등록부들의 목록을 포함 
한다. 이것은 ’ included ’ 파일들을 조사할 때 사용된다. 

QMAKE _ LIBDIR_OPENGL 

이 변수는 OpenGL 서고등록부의 위치를 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ LIBDIR_QT 

이 변수는 Qt 서고등록부의 위치을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LIBDIR _ X 1 1 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 XII 서고등록부의 위치을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAK 五 _LIBS 

이 변수는 모든 프로젝트서고들을 포함한다. 이 변수의 값은 전형적으로 qmake 혹 
은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ LIBS_CONSOLE 

이것은 Windows 에서만 사용된다 

이 변수는 콘솔응용프로그람을 건설할 때 련결되여야 할 모든 프로젝트서고들을 포 
함한다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문 
히 수정할 필요가 있 다. 

QMAKE _ LIBS_OPENGL 

이 변수는 모든 OpenGL 서고들을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ LIBS _ OPENGL_QT 

이 변수는 모든 OpenGL Qt 서 고들을 포함한다. 이 변수의 값은 전형 적 으로 qmake 
혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LIBS_QT 

이 변수는 모든 Qt 서 고들을 포함한다.이 변수의 값은 전형 적 으로 qmake 혹은 
qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LIBS _ QT_DLL 

이것은 Windows 에서만 사용된다 

이 변수는 Qt 가 dll 토서 건설될 때 Qt 서고들을 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ LIBS _ QT_OPENGL 
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이 변수는 OpenGL 유지가 선택되였으면 련결해야 할 모든 서고들을 포함한다. 이 
변수의 값은 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되 며 드문히 수정 할 
필요가 있다. 

QMAKE _ LIBS _ QT_THREAD 

이 변수는 스레드유지가 선택되였을 때 련결해야 할 모든 서고들을 포함한다. 이 
변수의 값은 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되 며 드문히 수정 할 
필요가 있다. 

QMAKE _ LIBS_RT 

이것은 Borland 를파 일 러 에 서 만 사용된다 

이 변수는 응용프로그람을 건설할 때 련결해야 할 실시간서고를 포함한다. 이 변수 
의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요 
가 있다. 

QMAK 五 _ LIBS_RTMT 

이것은 Borland 콤파 일 러 에 서 만 사용된다 

이 변수는 다중스레드응용프로그람을 건설할 때 련결해야 할 실행시서고를 포함한 

다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 

수정할 필요가 있다. 

QMAKE _ LIBS_THREAD 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 다중스레드응용프로그람을 건설할 때 련결해 야 할 모든 서고들을 포함한 

다. 이 변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 

수정할 필요가 있다. 

QMAKE _ LIBS_WINDOWS 

이것은 Windows 에서만 사용된다 

이 변수는 모든 windows 서고들을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ LIBS _ X 11 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 모든 XII 서고들을 포함한다. 이 변수의 값은 전형적으로 qmake 혹은 
qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAK 五- LIBS — X 11 SM 

이 것 은 Unix 가동환경 에 서 만 사용된 다 

이 변수는 모든 XII 쎄숀관리서고들을 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
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QMAKE _ LIB_FLAG 

이 변수는 ’1比)’형판이 지정되면 비지 않는다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의 하여 조종되 며 드문히 수정 할 필 요가 있 다. 

QMAKE _ LINK _ SHLIB_CMD 

이 변수는 공유서고를 창조할 때 실행해 야 할 지 령을 포함한다. 이 변수의 값은 전 
형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

QMAKE _ POST_LINK 

이 변수는 TARGET 를 모두 련결한 후에 실행할 지 령을 포함한다. 이 변수는 보통 
비 여있으므로 아무것도 실행되지 않으며 또한 일부는 이것을 유지 하지 않고 대체 로 
Makefile 뒤 면 ( backend ) 처 리 만 유지 한다. 

QMAKE _ PRE_LINK 

이 변수는 TARGET 를 모두 련결하기전에 실행할 지 령을 포함한다. 이 변수는 보 
통 비 여있으므로 아무것도 실행되지 않으며 또한 일부는 이것을 유지 하지 않고 대체 로 
Makefile 뒤 면 ( backend ) 처 리 만 유지 한다. 

QMAKE _ LN_SHLIB 

이 변수는 공유서고에 로의 련결을 창조할 때 실행할 지 령을 포함한다. 이 변수의 
값은 전형 적 으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 
있 다. 

QMAKE_MAKEFILE 

이 변수는 창조할 makefile 의 이름을 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ MOC_SRC 

이 변수는 프로젝트에 생성 및 포함하여야 할 모든 moc 원천파일들을 포함한다. 이 
변수의 값은 전형적으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 
필요가 있다. 

QMAKE_QMAKE 

이 변수는 qmake 가 경로안에 없을 때 그 위치를 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ QT_DLL 

이 변수는 Qt 가 dll 로서 건설되였다면 비지 않는다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

QMAKE _ RUN_CC 

이 변수는 객체 를 건설하는데 필요한 개 별적 인 규칙들을 지정한다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake.conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
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QMAKE _ RUN _ CC_IMP 

이 변수는 객체 를 건설하는데 필요한 개 별적 인 규칙들을 지정한다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
QMAKE _ RUN_CXX 

이 변수는 객체 를 건설하는데 필요한 개 별적 인 규칙들을 지정한다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
QMAKE _ RUN _ CXX_IMP 

이 변수는 객체 를 건설하는데 필요한 개 별적 인 규칙들을 지정한다. 이 변수의 값은 
전형적으로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
QMAKE_TARGET 

이 변수는 프로젝트목표의 이름을 포함한다. 이 변수의 값은 전형적으로 qmake 혹 
은 qmake . conf 에 의하여 조종되며 드문 히 수정할 필요가 있다. 

QMAKE—UIC 

이 변수는 uic 가 경로안에 없는 경우 그 위치를 포함한다. 이 변수의 값은 전형적 
으로 qmake 혹은 qmake . conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

물론 uic 에 추가적인 플라그인경로들과 갈은 인수들을 지정하는데 쓰일수 있다. 실 

례로 

QMAKE UIC = uic -L / path / to/plugin 
RC_FILE 

이 변수는 응용프로그람용자원파일의 이름을 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정 할 필요가 있다. 

RES_FILE 

이 변수는 응용프로그용자원파일의 이름을 포함한다. 이 변수의 값은 전형적으로 
qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

SRCMOC 

이 변수는 Q _ OBJECT 마크로를 포함하는 파일들을 발견할수 있는 경우에 qmake . 
에 의해 설정된다. SRCMOC 는 생성된 모든 moc 파일들의 이름을 포함한다. 이 변수의 
값은 전형 적 으로 qmake 혹은 qmake . conf 에 의 하여 조종되며 드문히 수정 할 필요가 
있 다. 

TARGET_EXT 

이 변수는 목표의 확장자를 지 정한다. 이 변수의 값은 전형 적 으로 qmake 혹은 
qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

TARGET—x 

이 변수는 기 본판번호를 가지 는 목표의 확장자를 지 정한다. 이 변수의 값은 전형 적 


339 




으로 qmake 혹은 qmake . conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 
TARGET _ x . y . z 

이 변수는 판번호를 가지 는 목표의 확장자를 지 정한다. 이 변수의 값은 전형 적 으로 
qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 

UICIMPLS 

이 변수는 UIC 가 생성한 실현파일들의 목록을 포함한다. 이 변수의 값은 전형 적으 
로 qmake 혹은 qmake . conf 에 의하여 조종되며 드문히 수정할 필요가 있다. 
PICOBJECTS 

이 변수는 UICIMPLS 변수로부터 생성된다. 매개 파일의 확장자는 .0 ( Unix ) 혹 
은 .obj ( Win 32) 로 교체된다. 이 변수의 값은 전형적으로 qmake 혹은 qmake . conf 에 
의 하여 조종되 며 드문히 수정할 필요가 있 다. 

VER_MAJ 

이 변수는 ’1比>’ 형판이 지정되면 서고의 기본판번호를 포함한다. 

VER_MIN 

이 변수는 ’1比)’ 형판이 지정되면 서고의 보조판번호를 포함한다. 

VER_PAT 

이 변수는 ’1比)’ 형판이 지정되면 서고의 패 치 ( patch ) 판번호를 포함한다. 
QMAKE _ EXT_MOC 

이 변수는 포함된 moc 파일들에서 사용한 확장자를 변경한다. 

또한 파일확장자참고. 

QMAKE _ EXT_UI 

이 변수는 /e Designer UI 파일들에 사용한 확장자를 변경한다. 
QMAKE _ EXT_PRL 

이 변수는 창조한 PRL 파일들에 사용된 확장자를 변경한다. 

QMAKE _ EXT_LEX 

이 변수는 lex 에 주어 진 파일들에 사용한 확장자를 변경한다. 
QMAKE _ EXT_YACC 

이 변수는 yacc 에 주어 진 파일들에 사용한 확장자를 변경한다. 

QMAKE _ EXT_OBJ 

이 변수는 생성한 목적파일들에 사용한 확장자를 변경한다. 

QMAKE _ EXT_CPP 

이 변수는 이 값목록안의 모든 뒤붙이들을 C ++ 원천코드형의 파일들로 해석한다. 
QMAKE _ EXT_H 

이 변수는 이 값목록안의 모든 뒤 붙이 들을 C 머 리 부파일 형 의 파일 들로 해 석한다. 
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YACCIMPLS 

이 변수는 yacc 원천파일들의 목록을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

YACCOBJECTS 

이 변수는 yacc 목적파일들의 목록을 포함한다. 이 변수의 값은 전형적으로 qmake 
혹은 qmake.conf 에 의 하여 조종되며 드문히 수정 할 필요가 있다. 

3. 함수 

qmake 는 다음과 같은 함수들을 인식한다. 
include ( filename ) 

이 함수는 filename 의 내용을 현재 프로젝트안의 포함될 위치에 포함한다. 함수는 
filename 이 포함되면 성공하고 그렇지 않으면 실패한다. 유효범위를 사용하여 이 함수 
의 돌림값을 검사할수 있다. 

실례 

include( shared.pri ) 

OPTIONS = standard custom 
!include( options.pri ) { 

message( "No custom build options specified" ) 

OPTIONS -= custom 

} 

exists( file ) 

이 함수는 file 이 존재하는가 검사한다. 파일이 존재하면 성공하고 그렇지 않으면 
실패한다. 파일에 정규식을 지정할수 있으며 임의의 파일이 지정된 정규식과 대조되면 
성공한다. 

실례 

exists( $(QTDIR)/lib/libqt-mt* ) { 

message( "Configuring for multi-threaded Qt..." ) 

CONFIG += thread 

} 

contains( variablename, value ) 

이 함수는 변수 variablename 가 값 value 를 포함하면 성공한다. 유효범위를 사용 
하여 이 함수의 돌림값을 검사할수 있다. 

실례 

contains( drivers, network ) { 

# drivers contains 'network' 
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message( "Configuring for network build..." ) 

HEADERS += network.h 
SOURCES += network.cpp 

} 

count( variablename, number ) 

이 함수는 변수 variablename 가 number 요소를 포함하면 성공하고 그렇지 않으면 
실패한다. 유효범위를 사용하여 이 함수의 돌림값을 검사할수 있다. 

실례 

MYVAR = one two three 
count( MYVAR, 3 ) { 

# always true 

} 

infile( filename, var, val ) 

이 함수는 파일 filename(qmake 자체에 의해 해석될 때)이 값 val 을 가진 변수 
var 를 포함하면 성공한다. 또한 제 3 인수 (val) 를 넘기지 않을수 있으며 함수는 var 가 
파일 안에 할당되였는가만 검사한다. 
isEmpty( variablename ) 

이 함수는 변수 variablename 이 비 였 으면 (count(variable, 0) 이 면) 성 공한다. 
system( command ) 

이 함수는 둘째엘에서 command 을 실행하며 지령이 완료상태 1 로 끝나면 성공한다. 
유효범 위 를 사용하여 이 함수의 돌림값을 검 사할수 있 다. 

실례 

system(ls /bin):HAS_BIN=FALSE 
message( string ) 

이 함수는 늘 성공하며 사용자에게 주어진 string 을 현시한다. 
error( string ) 

이 함수는 절대로 값을 돌려주지 않는다. 사용자에게 주어진 string 을 현시하고 
qmake 를 완료한다. 이 함수는 오직 매우 중요한 환경구성에만 사용되 여 야 한다. 

실례 

release:debug:error(You can't have release and debug at the same time!) 


4. 속성 

qmake 는 영속정보체계를 가지며 이것은 qmake 에서 일단 변수를《설정》하게 하며 
qmake 가 호출될 때마다 이 값이 질문될수 있다. 다음것을 사용하여 qmake 에서 속성을 
설 정 한다. 
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qmake -set VARIABLE VALUE 

qmake 로부터 이 정보를 엄으려면 다음과 같이 할수 있다. 

qmake -query VARIABLE 

qmake -query #queries all current VARIABLE/VALUE pairs .. 

이 정 보는 QSettings 객체 에 보관된다.(이것은 서 로 다른 가동환경들에서 서 로 다 
른곳에 보관된다.) VARIABLE 이 판으로 될 때 낡은 판의 qmake 에 한개 값을 설정할 
수 있 으며 새 로운 판들이 이 값을 얻 지 만 qmake 의 새 판에 VARIABLE 을 설 정하면 
낡은 판이 이 값을 사용하지 않는다. 그러나 다음과 같이 qmake 의 판을 VARIABLE 
앞에 놓으면 변수의 특정판을 질문할수 있다. 

qmake -query "1.06 a / VARIABLE " 

또한 qmake 는 ’builtin’ 속성들의 표기를 가진다. 실례로 

QT _ INSTALL_PREFIX 속성을 사용하여 이 판의 Qmake 에 대하여 어의 설치를 질문 
할수 있다. 

qmake -query " QT _ INSTALL _ PREFIX " 

이 기본속성들이 판이 아닐 때 그것들앞에 판을 놓을수 없으며 매개 qmake 는 이 
값들의 자체의 표기를 가전다. 아래의 목록은 기본속성들을 보여준다. 

• QT _ INSTALL_PREFIX - qmake 가 상주용으로 건설되는 Qt 판의 위 치 

• QT _ INSTALL_DATA - 이 판의 Qt 자료가 상주하는곳 

• QMAKE_VERSION - qmake 의 현재 판 

끝으로 이 값들은 다음과 같이 특정한 표기 를 가지 는 프로젝 트파일안에 서 질 문될 수 
있 다. 

QMAKE_VERS = $$ [ QMAKE _ VERSION ] 

5. 환경변수와 환경구성 

1) QMAKESPEC 

qmake 는 적당한 makefile 들을 생성하는데 쓰이는 수많은 기정값들을 포함하는 가 
동환경과 콤파일러서술파일을 요구한다. 표준 Qt 배포물은 이러한 파일들을 수많이 포함 
하며 그것들은 Qt 설치의 ’ mkspecs ’ 보조등록부에 배치된다. 

QMAKESPEC 환경변수는 다음의 값들중 임의의것을 포함할수 있다. 

• qmake . conf 파일을 포함하는 등록부에로의 완전경로. 이 경우에 qmake 는 그 등 
록부안으로부터 qmake . conf 파일 을 연다. 파일 이 존재 하지 않으면 qmake 는 오유로 완 
료한다. 

• 가동환경 -를파일 러 결 합의 이 름. 이 경 우에 qmake 는 QTDIR 환경 변수에 의 해 지 
정된 등록부를 람색한다. 

알아두기 : QMAKESPEC 경 로는 INCLUDEPATH 체 계 변수에 자동적 으로 추가된 
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다. 


2) INSTALLS 

건설할 때 (실례로 make install ) 같은 편의프로그람으로부터 설치할수 있게 하는것 
이 UNIX 에서 상식 이 다. 이를 위하여 qmake 는 설치모임의 개 념을 도입하였다. 이를 
위한 표기 는 아주 간단하며 우선 qmake 실례 에서 《객체》를 채운다. 
documentation.path = /usr/local/program/doc 
documentation.files = docs/* 

이 방법에서 qmake 에게 이 설치에 대하여 몇가지 말하고있다. 첫째로 
_/ usr / local / program / doc ( path 성원)에 설치하려고 계획하며 둘째로 docs 등록부에 모 
든것을 복사할 계획이다. 이것을 수행하면 설치목록에 그것을 삽입할수 있다. 

INSTALLS += documentation 

그러면 qmake 는 정확한것들이 지정된곳에 복사되는가 확인한다. 그러나 더 큰 조 
종을 요구한다면 객체의 ’ extra ’ 성원을 요구할수 있다. 

unix : documentation.extra = create_docs; mv master.doc toe.doc 

그다음 qmake 는 나머 지 를 실 행 한다. (이 것 은 물론 가동환경 에 고유하므로 우선 자 
기 가동환경 에서 시험할 필요가 있으며 이 경우에는 unix 에서 시험한다.) 그때 파일성 
원의 표준처 리 를 수행한다. 끝으로 INSTALLS 에 기 본설 치 를 추가한다면 qmake (그리 
고 파일 이 나 여 분의 성 원을 지 정하지 않는다)는 무엇 을 복사해 야 하는가를 결 심하며 현 
재는 오직 유지된 기본설치만 목표이 다. 
target.path = /usr/local/myprogram 
INSTALLS += target 

이 리 하여 qmake 는 무엇을 복사해 야 하는가 알고있으며 이것 을 수행 한다. 

3) 캐쉬파일 

캐쉬파일 (우의 선택에서 언급)은 qmake 가 qmake.conf 파일 ， .pro 파일 혹은 지령행에 
서 지정되지 않은 설정값들을 찾기 위하여 읽어들이는 특수파일이다. -nocache 이 지정되 
지 않으면 qmake 는 부모등록부들에서 .qmake.cache 라는 파일을 찾으러고 한다. 이 파 
일 을 찾는데 서 실 패하면 이 처 리단계 를 말없 이 무시 한다. 

4) 서고의존관계 

흔히 서 고에 련결 할 때 qmake 는 기 초하고있는 가동환경 에 의 거 하여 이 서 고를 어 
떤 다른 서고와 련결해 야 하는가를 알아내고 가동환경 이 그것들을 포함하게 한다. 그러 
나 많은 경우에 이것은 충분하지 않다. 실례로 서고를 정적으로 련결할 때 련결할 서고 
가 없으므로 그 서고들에 대한 의존관계들이 창조된다. 그러나 후에 이 서고에 련결하는 
응용프로그람은 서고에서 련결되는것들이 요구하는 기호들을 찾기 위한 위치를 알아야 
한다. 이 러한 상황을 방조하기 위하여 qmake 는 적 당하다고 느껴질 때 서고의 의존관계 
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를 따르지만 이 동작은 qmake 에서 허용되여야 한다. 그러자면 두 단계가 요구된다. 우 
선 서고에서 그것을 허용해야 한다. 그러자면 qmake 에게 이 서고에 대한 정보를 보관 
할것 을 알려야 한다. 

CONFIG += create_prl 

이것은 오직 lib 형판에만 관련되며 다른 모든것은 무시된다. 이 선택이 허용될 때 
qmake 는 서 고에 대 한 메 타정 보를 보관하는 파일 (. prl 파일)을 창조한다. 이 메 타파일은 
그자체가 바로 qmake 프로젝트파일이지만 모든 내부변수들을 가전다. 이 파일을 보는것 
은 자유이다. 지워졌으면 qmake 는 필요할 때 (. pro 파일을 후에 읽어들일 때 혹은 아래 
에 보여주는것처럼 의존서고가 변경된 경우에) 다시 창조하는것을 알고있다. 우에서 
INSTALLS 안의 목표를 사용하여 이 서고를 설치할 때 cjmake 는 . prl 파일을 자기의 설 
치경로에 자동적으로 복사한다. 

이 처리를 허용하는 둘째 단계는 우에서 창조된 메타정보의 읽기를 선택하는것이다. 

CONFIG ，_ link_prl 

이것이 설정될 때 qmake 는 련결된 서고들을 모두 처리하고 그 메타정보를 찾는다. 
이 메타정보를 리용하여 qmake 는 련결과 관계되는것들을 종합하고 특히 LIBS 는 물론 
자기의 DEFINES 의 목록에 추가한다. 일단 qmake 가 이 파일을 처 리하였으면 새 로 생 
겨난 LIBS 들을 조사하여 그 의존하는 . prl 파일들을 찾고 모든 서 고들을 해 결하였을 때 
까지 계속한다. 이 시점에서 보통 makefile 이 창조되고 서고들은 명시적으로 자기 프로 
그람에 련결된다. 

. prl 파일의 내부는 닫겨져있으므로 후에 쉽게 변경할수 있다. 이것은 손으로 변경 
할수 있게 설계되지 않지만 qmake 에 의해서만 창조되여야 한다. 이 . prl 파일들은 또한 
가동환경 에 의존할 때 ( makefile 처 럼) 조작체 계 사이 를 옮기지 말아야 한다. 

5) 파일확장자 

보통환경에서 qmake 는 자기의 가동환경을 위 한 적당한 파일 확장자를 사용하려고 
한다. 여 러 가지 경 우가 있을수 있지 만 보통 이 확장자들을 무시하려 고 한다. 그러 자면 
자기의 . pro 파일에서 기본 ( builtin ) 변수들을 수정해야 하며 그 변수들은 또한 이 파일 
들의 qmake 해 석 을 변경 한다. 다음과 같이 수행 할수 있 다. 

QMAKEEXTMOC = .mymoc 

변수들은 다음과 갈다. 

QMAKE _ EXT_MOC - 포함한 moc 파일들에 배 치된 확장자를 수정한다. 

QMAKE _ EXT_UI - designer UI 파일들(보통 FORMS 에서)에 사용된 확장자를 수정한다. 

QMAKE _ EXT_PRL - 서 고의존관계파일들에 배 치된 확장자를 수정한다. 

QMAKE _ EXT_LEX -파일들에 사용된 뒤붙이 를 변경 한다. (보통 LEXSOURCES 에서) . 

QMAKE _ EXT_YACC - 파일들에 사용된 뒤 붙이 를 변경한다. (보통 
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YACCSOURCES 에 서 ). 

QMAKE _ EXT_OBJ - 생성된 목적 파일들에 사용된 뒤 붙이를 변경한다. 

우에서는 바로 첫째값을 받아들이므로 거기에 자기의 makefile 에 사용해야 할 값을 
할당해 야 한다. 값목록을 받아들이는 두개의 변수들이 있는데 그것들은 다음과 갈다. 

• QMAKE _ EXT_CPP - 해석에서 이 뒤붙이를 가지는 모든 파일들을 C ++ 원천파 
일들로 변경한다. 

• QMAKE _ EXT_H - 해석에서 이 뒤붙이를 가지는 모든 파일들을 C 머리부파일들 
로 변경한다. 

6) Makefile 출력의 전용화 

흔히 qmake 는 모든것을 건설도구를 리용하여 수행하려고 하는데 이것은 특수한 가 
동환경에 의존하는 지령들을 실제로 실행할 필요가 있을 때 리상적이지 못하다. 이것은 
각이한 Qmake 뒤면처리를 위한 특정한 지령에 의해 이룩될수 있다. (현재 이것은 UNIX 
생 성 기 에 서 만 유지 하고있 다. ) 

Makefile 을 전용화하기 위 한 대면부는 qmake 안의 다른곳에서 처 럼 《객체》들을 통 
하여 수행된다. 이 를 위한 표기는 아주 간단하며 우선 qmake 실례의 《객체》를 채 운다. 
mytarget.target = .buildfile 
mytarget.commands = touch $$mytarget.target 
mytarget.depends = mytarget2 

mytarge 接 . commands = @echo Building $$mytarget.target 

우의 정보는 .buildfile 이라는 Makefile 목표를 포함하는 mytarget 라는 qmake 목 
표를 정의하며 .buildfile 은 ’touch .buildfile ’에 의해 생성되고 끝으로 이 Makefile 
목표는 qmake 목표 mytarget 2 에 의존한다. 추가적으로 stdout 에 무엇인가 단순히 반영 
하는 qmake 목표 mytarget 2 를 정의 하였다. 

우의것을 사용하게 하는 마지막 단계는 실제로 이것이 qmake 의 목표건설부분들에 
의해 다음과 같이 사용되는 객체라는것을 qmake 에 지령하는것이다: 

QMAKE_EXTRA_UNIX_TARGETS += mytarget mytarget2 

이것이 qmake 로 전용목표들을 실제로 건설할 때 수행해야 하는 모든것이다. 물론 
목표들중 하나를 종속시켜 Qmake 건설목표를 실제로 건설하려고 할수 있다. 그러자면 
PRE_TARGETDEPS 목록에 자기의 Makefile 목표를 단순히 포함할 필요가 있다. 

편리상 새로운 범용롬파일러(혹은 지 어 앞처 리기)용으로 (UNIX) 프로젝트들을 전 
용화하는 방법도 있다. 

newmoc.output = moc_$ {QMAKEFILEBASE} .cpp 

new moc.commands = moc $ {QMAKE FILE NAME} -o $ {QMAKE FILE OUT} 

new_moc.depends = g++ -E -M ${QMAKE_FILE_NAME} | sed ， ’ s, A .*: ”" 
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QMAKE EXTRA UNIX COMPILERS new_moc 

이것을 리 용하여 qmake 용의 새로운 moc 를 창조할수 있으며 지령들은 
NEW _ HEADERS 변수(입 력 변수로부터)에 주어 진 모든 인수들에 대 하여 실행 되 고 출력 
에 써 넣 는다. 그리 고 자기 목표에 련결 하기 위하여 이 파일 이 름을 롬파일 러 에 자동적으 
로 넘긴다. 또한 Qmake 가 실행하는것은 의존관계정보의 생성에 의존하며 물론 프로젝 
트파일에 이것을 배치한다. 

이 지령들은 캐쉬파일에 쉽게 배치될수 있으며 그 다음의 .pro 파일들은 
NEW _ HEADERS 에 여러개의 인수를 줄수 있다. 



제 5 장. 기타 도구들 


제1절. QEmbed - 파일 및 화상매몰프로그람 

QEmbed 도구는 qt/tools/qembed 에 있으며 임의의 파일을 C++ 코드로 변환한다. 이것 
은 외부파일들로부터 자료를 적재하지 않고 화상파일들과 다른 자원들을 직접 포함하는 
데 쓸모있다. 

또한 QEmbed 는 자기 의 응용프로그람에 직 접 포함할수 있는 비 압축판의 화상들을 
생성하여 외부파일과 화상파일형 식 해 석요구를 피할수 있다. 이것은 압축이 큰 리득을 주 
지 않는 그림기 호과 갈은 작은 화상들에 사용할수 있 다. 

1. 사용법 

qembed [ general-files ] [ —images image-files ] 

•general-files 

이 파일들은 임의의 형의 파일일수 있다. 

•—images image-files 

이 파일들은 Qt 가 유지하는 화상형식이여야 한다. 

2. 출력 

QEmbed 로부터 의 출력 은 C++ 원천파일 에 서 포함해 야 할 C++ 머 리 부파일 이 다. 원천 
파일에서 자기의 응용프로그람에 적합한 래퍼함수를 만들어 야 한다. 두 함수가 제공된다. 
래퍼함수는 이것들중 하나를 호출하거나 자체로 실현할수 있다. 여기에 제공된 매개 함 
수들을 사용하는 간단한 실례가 있다. 

① qembed_findlmage() 

#include "generated_qembed_file.h" 

Qlmage myFindImage(const char* name) 

{ 

return qembed_findlmage(name); 

} 

생성된 함수를 호출한다. name 은 확장자없는 원시화상파일이름이다. 

② qembed_findData() 

^include ”generated_qembed_file.h" 

QByteArray myFindData(const char* name) 

{ 
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return qembed_findData(name); 

} 

생성된 함수를 호출한다. name 은 확장자있는 원시화상파일이름이다. 

또한 QEmbed 로부터의 출력을 고찰하고 자기의 요구에 맞는 함수를 쓴다. 

제2절. Qt / Embedded 가상틀완충기 

가상틀완충기는 탁상기계에서 콘솔과 XII 을 절환하지 않고 Qt / Embedded 프로그 
람들을 개 발하게 한다. 

가상틀완충기 는 $QTDIR/tools/qvfb 에 위 치 되 여 있 다. 

1. 가상틀완충기의 사용 

① - qvfb 인수를 가지고 Qt / Embedded 의 환경을 구성 하고 서고를 름파일한다. 

. / configure -qvfb 
make 

② 표준 Qt / Xll 응용프로그람으로서 qvfb 를 름파일하고 실행한다. Qt / Embedded 응 
용프로그람로서 그것 을 름파일 하여 서 는 안된 다. 

③ Qt / Embedded 주응용프로그람을 기 동한다. 즉 QApplication : : GuiServer 기 발 
을 리 용하여 QApplication 을 구축하거 나 - qws 지 령 행 파라메터 를 사용한다. 가상틀완충 
기구동기를 사용하려고 한다는것을 봉사기에게 지정할수 있다. 실례로 

masterapp -qws -display QVFb : 0 

④ Qt / Embedded 는 qvfb 를 자동탐지 하므로 qvfb 를 실행 하고있고 Qt/Embedded 
서 고가 qvfb 를 유지 한다는것 을 알고있 으면 - display 지 령 행 파라메 터 를 생 략할수 있 다. (그 
렇지 않으면 Qt / Embedded 는 실제의 틀완충기에 써넣으며 자기의 XII 현시기는 제대로 
동작하지 않는다.) 


qvfb 는 다음과 같은 지 령행선택을 유지 한다. 


표 5-1. 

qvfb 의 지 령행선택 

선택 

의미 

-width width 

가상틀완충기의 폭 (기정값: 240). 

-height height 

가상틀완충기의 높이 (기정값: 320). 

-depth depth 

가상틀완충기의 깊이 (1, 8 or 32； 기정값: 8). 

-nocursor 

틀완충기 창문에 서 XII 유표를 표시하지 않는다. 

-qwsdisplay : id 

제공하려는 Qt / Embedded 현시기식별자 (기정값: ：0). 
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2. 가상틀완충기설계 

가상틀완충기는 공유기억령역(가상틀완충기)과 틀완충기를 창문에 현시하는 편의프 
로그람 (qvfb) 을 리용하여 틀완충기를 모의한다. 변경된 현시기의 령역은 주기적으로 갱 
신되므로 매개의 개별적인 그리기조작보다 리산적인 틀완충기의 장면들을 보게 된다. 이 
러 한 리유로 깜빡거 림 과 같은 그리 기문제 는 프로그람이 실제 의 틀완충기 를 리용하여 실 
행될 때까지 겉에 나타나지 않는다. 

목표재생비률은 View | Refresh Rate 차림표항목을 거처서 설정될수 있다. 이것은 
qvfb 가 갱신된 령역을 더 자주 검사하게 한다. 그 비률은 목표뿐이 다. 약간한 그리기가 
수행 되 고있으면 틀완충기 는 그리 기사건들사이 의 갱 신을 표시하지 않는다. 응용프로그람 
이 동화상을 표시 하고있으면 갱 신은 빈번해 지 고 응용프로그람과 qvfb 는 처 리소자시 간에 
완료한다. 

마우스와 건반사건들은 이름있는 파이프를 거처서 Qt/Embedded 마스터처리에 넘 
겨진다. 

가상틀완충기는 개발도구뿐이다. 보안문제는 가상틀완충기설계에서 고려되지 않으 
며 산품환경에서 피해야 하며 -qvfb 를 리용하여 산품서고들의 환경을 구성하지 않는다. 

제3절. makeqpf 

서 체 들을 묘사하고 보관함으로써 QPF 서 체파일들을 절 약한다. 

사용법 

makeqpf [-A] [-f spec-file] [font ...] 

-A - fonMir 에 모든 서 체들을 묘사하고 보관한다. 

-f - 행들의 파일 : 서체 이름 문자-범위 실례로 "smoothtimes 0-ff , 20a0-20af" 
font - 묘사하고 보관하려 는 서체 

제4절. 메타객체콤파일러 moc 

메 타객 체 콩파일 러 (Meta Object Compiler) moc 는 Qt 의 C++ 확장을 조종하는 프로그 
탐이 다. 

moc 는 C++ 원천파일을 읽어들인다. 그것 이 Q_OBJECT 마크로를 포함하는 하나이 상 
의 클라스선언을 발견하면 Q_OBJECT 마크로를 사용하는 클라스들에 대한 메타객체코 
드를 포함하는 다른 C++ 원천 파일 을 생 성한다. 다른것 들중에 서 메 타객 체 코드는 신호-처 
리부기구, 실행시형정보 및 동적속성체계에 요구된다. 
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moc 가 생성한 C++ 원천파일은 콜라스의 실현과 함께 름파일되고 련결되여야 한다. 
혹은 클라스의 원천파일에 포함 (include) 될수 있다. 

qmake 를 사용하여 자기의 Makefile 들을 창조한다면 필요할 때 moc 를 호출하는 
건설규칙들이 포함되므로 moc 를 직접 사용할 필요가 없다. moc 에 대한 더 자세 한 정보 
는 《Qt 일반지식》3장 6절을 참고하시오. 

1. 사용법 

moc 는 보통 다음과 같이 클라스선언을 포함하는 입력파일에서 사용된다. 
class MyClass : public QObject 
{ 

Q_OBJECT 

public: 

MyClass( QObject * parent=0, const char * name=0 ); 

〜 MyClass(); 
signals: 

void mySignal(); 
public slots: 
void mySlot(); 

}； 

우에서 보여준 신호 및 처리부와 함께 moc 는 또한 다음 실례에서처럼 객체속성들 
을 실현한다. Q_PROPERTY 마크로는 객체속성을 선언하며 한편 Q_ENUMS 은 속성체 
계안에서 사용할수 있도륵 클라스안에 렬거형목록을 선언한다. 이 와 같이 특수한 경우에 
priority 라고도 불리 우며 하나의 얻 기함수 priority() 와 하나의 설정 함수 setPriority() 를 가 
지는 렬거형 Priority 의 속성을 선언한다. 
class MyClass : public QObject 
{ 

Q_OBJECT 

Q_PROPERTY( Priority priority READ priority WRITE setPriority ) 

Q_ENUMS( Priority ) 
public: 

MyClass( QObject * parent=0, const char * name=0 ); 

〜 MyClass(); 

enum Priority { High, Low, VeryHigh, Very Low }; 
void setPriority( Priority ); 
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Priority priority() const; 

}； 

속성 들은 Q_OVERRIDE 마크로에 의해 파생 클라스에 서 수정 될 수 있 다. Q_SETS 마 
크로는 모임으로서 즉 모두 OR 될수 있는 enum 들을 선언한다. 다른 마크로 
Q_CLASSINF ◦는 이름-값 쌍을 클라스의 메타객체에 련결하는데 쓰일수 있다. 
class MyClass : public QObject 
{ 

Q_OBJECT 

Q_CLASSINFO( "Author", "Oscar Peterson") 

Q_CLASSINFO( "Status", "Active") 
public: 

MyClass( QObject * parent=0, const char * name=0 ); 

~MyClass(); 

}； 

3 가지 개념 즉 신호 및 처리부，속성과 클라스메타자료를 결합할수 있다. 

moc 에 의해 생성된 출력은 자기의 프로그람에서 다른 C ++ 코드와 같이 를파일되고 
련결되여야 한다. 그렇지 않으면 건설은 최종련결단계에서 실패한다. 편리상 이것은 다 
음의 두가지 방법들중 하나에 의해 수행된다. 

방법1: 클라스선언을 머 리부파일(.비에서 발견한다. 

믈라스선언이 파일 mycla , S _ s ,. h 에서 발견되면 moc 출력은 moc _ myclass.cpp 라는 
파일에 놓여야 한다. 그때 이 파일은 보통과 같이 름파일되여 목적파일 
moc _ myclass.o (Unix 에서) 혹은 moc _ myclass.obj (Windows 에서)가 생성된다. 그 
때 이 목적파일은 프로그람의 최종건설단계에서 모두 련결되는 목적파일목록에 포함되여 
야 한다. 

방법 2: 콜라스선언을 실현파일 (.cpp) 에서 발견한다. 

콜라스선언이 파일 myclass.cpp 에 있다면 moc 출력은 myclass.moc 라는 파일에 
놓여야 한다. 이 파일은 실현파일에 포함되여야 한다. 즉 myclass.cpp 은 끝에 다음 행 
을 포함하여 야 한다. 

#include "myclass.moc" 

이것은 moc 가 생성한 코드를 틈파일하여 myclass.cpp 안의 보통콜라스정의와 련결 
되게 하므로 방법 A 에서처럼 그것을 따로따로 롬파일하고 련결할 필요가 없다. 

방법 A 는 보통의 방법이다. 방법묘는 실현파일이 자체로 포함되게 하려고 하는 경우나 
Q_OBJECT 클라스가 내부실현이므로 머리부파일에서 볼수 없는 경우에 사용될수 있다. 
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2. Makefile 에 의하여 moc 사용의 자동화 

어떤 가장 단순한 시험프로그람에서는 moc 의 실행을 자동화할것을 권고한다. 자기 
프로그람의 Makefile 에 규칙들을 추가함으로써 make 는 필요할 때 moc 의 실행과 moc 
출력의 조종을 고려할수 있다. 

Trolltech 의 무료의 makefile 생성도구인 qmake 를 사용하여 자기의 Makefile 들을 
건설할것을 권고한다. 이 도구는 방법 A 와 B 형식의 원천파일들을 모두 인식하며 필요한 
moc 조종을 모두 수행 하는 Makefile 을 생성 한다. 

Makefile 들을 자체로 창조하려고 한다면 여기에 moc 조종을 포함하는 방법에 대한 
암시가 있다. 

머 리 부파일안의 Q_OBJECT 클라스선언 에 대 하여 서 는 아래 에 GNU make 를 사용하 
는 경우에만 쓸모있는 makefile 이 있다. 
moc_%.cpp: %上 
moc $< -o $@ 

이 식할수 있게 하려 면 다음의 형 식 으로 독특한 규칙 들을 사용할수 있다. 
moc NAME.cpp: NAME.h 
moc $< -o $@ 

또한 자기의 SOURCES (자기가 애호하는 이름을 대리)변수에 moc _ NAME.cpp 를， 
OBJECTS 변수에 moc _ NAME.o 혹은 moc _ NAME.obj 를 추가하는것을 기억하여야 한 
다. ( C ++ 원천파일들을 .cpp 라고 이름짓기를 좋아하여도 moc 가 그것을 고려하지 않으므 
로 . C , . cc , . CC , .cxx 혹은 . C ++ 를 사용할수도 있다.) 

실현파일 (. cpp ) 의 Q_OBJECT 들라스선언에서는 다음과 같은 makefile 규칙을 제 안 
한다. 

NAME.o: NAME.moc 
NAME.moc: NAME.cpp 
moc -i $< -o $@ 

이것은 NAME.cpp 을 를파일하기전에 make 가 moc 를 실행한다는것을 담보한다. 
그다음 NAME , cpp 의 끝에 다음 행을 넣을수 있다. 

#include "NAME.moc” 

그 파일에서 선언한 모든 콜라스들은 충분히 알려져있다. 

3. moc 의 호출 

여기에 moc 에 의해 지원되는 지령행선택들이 있다. 
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표 5-2. 

moc 의 지 령 행 선 택 

선택 

의미 

-o file 

출력을 stdout 가 아니 라 file 에 써 넣는다. 

-f 

출력에 #include 문의 생성을 강요한다. 이것은 이름이 정규식 \. [ hH ] 

r .]* (즉 확장자는 H 혹은 h 로 시작한다.)과 일치하는 파일들에 기정이 

다. 이 선택은 오직 표준명명관례를 따르지 않는 머리부파일이 있는 경우 

에 사용할수 있다. 

-i 

출력에서 #include 문을 생성하지 않는다. 이것은 하나이상의 클라스선언 

을 포함하는 C ++ 파일에 대하여 moc 를 실행하는데 쓰일수 있다. 그때 .c 

PP 파일에 메타객체코드를 포함하여야 한다. - i 와 아가 둘다 제시되면 -f 

가 선택된다. 

-nw 

어떤 경고도 생성하지 않는다. 권고하지 않는다. 

- ldbg 

stdout 에 대 량적 인 문법오유수정정보를 써 넣는다. 

- p path 

moc 가 생성된 include 문(생성된 경우)안의 파일이름에로의 path / 를 
받아들이게 한다 ( prepend ). 

-q path 

moc 가 생성된 코드안의 qt #include 과일들의 파일이름에로의 path / 를 

받아들이게 한다. 


moc 가 머리부파일부분을 구문해석하지 못한다는것을 명백히 말할수 있다. 이것은 
부분문자렬 MOC _ SKIP_BEGIN 혹은 MOC _ SKIP_END 를 포함하는 C ++ 설명문(/八을 
인식한다. 그것들은 기대한대로 작업하며 그것들의 여러 준위를 가질수 있다. moc 로 보 
았을 때 순수한 결과는 MOC _ SKIP_BEGIN 과 MOC _ SKIP_END 사이의 모든 행들을 
삭제한것 과 같다. 

4. 진단 

moc 는 Q_OBJECT 들라스선언안의 많은 위험 한 혹은 옳지 않은 구성 에 대 하여 경 
고한다. 

자기 프로그람의 최종건설단계에서 YourClass : : className () 가 정의되지 않거나 
YourClass 가 야비를 잃었다는것을 말하는 련결오유들을 엄으면 일부는 틀리게 수행되 
였다. 대체로 moc 가 생성한 C ++ 코드를 콤파일하거나 포함 ( include ) 하는것을 잊었거나 
(전자의 경우에) link 지령에서 그 지령을 포함하는것을 잊었다. 

5. 제한 

moc 는 #include 혹은 #define 를 전개하지 못하며 단순히 앞처리지령을 만날 때마 
다 뛰여넘는다. 이것은 보통 실천에서는 문제가 없다. 
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moc 는 C ++ 의 모두를 조종하지 못한다. 기본문제는 클라스형판들이 신호나 처리부 
를 가질수 없는것이다. 여기에 실례가 있다: 

class SomeTemplate<int> : public QFrame { 

Q_OBJECT 


signals: 

void bugInMocDetected( int ); 

}； 

좀 중요하지만 다음의 구성은 비법적이다. 

1) 다중계승은 QObject 을 처음에 놓을것을 요구한다 

다중계승을 사용하고있다면 moc 는 처음으로 계승하는 들라스가 QObject 의 파생콜 
라스타고 가정한다. 또한 처음으로 계승된 콜라스가 QObject 라는것을 확인해 야 한다. 
class SomeClass : public QObject, public OtherClass { 


}; 

(이 러 한 제 한은 거 의 제 거할수 없 다. moc 가 # include 혹은 # define 을 전개 하지 못 
하므로 어느 기초클라스가 QObject 인가 찾을수 없다.) 

2) 함수지적자들은 신호나 처리부에 인수로 될수 없다 

신호-처리부인수로서 함수지적자의 사용을 고려하는 대부분의 경우에 계승이 더 좋 
은 후보라고 생각한다. 여기에 틀린 문법의 실례가 있다. 
class SomeClass : public QObject { 

Q_OBJECT 


public slots: 

// illegal 

void apply( void (*apply)(List *, void *), char * ); 

}； 

이 제 한에 대 하여 다음과 같이 작업할수 있 다. 
typedef void (*ApplyFunctionType)( List *，void * ); 


class SomeClass : public QObject { 
Q_OBJECT 


public slots: 
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void apply( ApplyFunctionType, char * ); 

}； 

흔히 함수지적자를 계승과 가상함수，신호나 처리부로 바꾸는것 이 더 나을수 있다. 

3) 동료선언은 신호나 처리부절에 놓일수 없다 

흔히 이것은 동작하지만 일반적으로 동료선언은 신호나 처리부절에 배치될수 없다. 
그대신에 그것을 private , protected 혹은 public 절에 놓아야 한다. 여기에 옳지 않은 
문법의 실례가 있다. 

class SomeClass : public QObject { 

Q_OBJECT 


signals: 

friend class ClassTemplate<char>; // WRONG 

}； 

4) 신호와 처 리부는 갱신될수 없다 

계승한 성원함수를 공개상태로 갱신하는 C ++ 특성은 신호와 처리부를 포함하는데까 
지 전개되지 않는다. 여기에 옳지 않은 문법의 실례가 있다. 
class Whatever : public QButtonGroup { 


public slots: 

QButtonGroup::buttonPressed; // WRONG 


}； 

QButtonGroup::buttonPressed() 처 리 부는 protected 이 다. 

C ++ 질문: 다중정의되는 protected 성원함수를 갱신하려고 한다면 어떤 일이 생기는가? 

建) 모든 함수는 다중정의된다. 

③ 이것은 옳은 C++ 가 아니다. 

5) 형 마크로는 신호와 처 리 부파라메터 로서 사용될수 없 다 

moc 가 # define 를 전개하지 못하므로 인수있는 형마크로들은 신호와 처리부에서 작 
업하지 않는다. 여기에 옳지 않은 실례가 있다. 

#ifdef ultrix 

#defme SIGNEDNESS(a) unsigned a 
#else 

#defme SIGNEDNESS(a) a 
#endif 
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class Whatever : public QObject { 


signals: 

void someSignal( SIGNEDNESS(int) ); 


}； 

인수없는 # define 은 기대한대로 작업한다. 

6) 겹쌓인 클라스들은 신호나 처리부를 가지지 않는 신호나 처리부절에 있을수 없다 
여기에 실례가 있다. 

class A { 

Q_OBJECT 
public: 
class B { 

public slots: // WRONG 
void b(); 

}； 

signals: 

class B { // WRONG 

void b(); 

}： 

}； 

7) 구성자들은 신호나 처리부절에서 사용될수 없다 

신호나 처 리부절에 구성자를 왜 넣군하는가 하는것 이 비결 이 다. 어떤 방법 으로도 
할수 없다. (작업과정에 그런 일이 발생하는 경우를 제외.) 구성자들이 속해있는 
private , protected 혹은 public 절에 그것들을 넣어야 한다. 여기에 옳지 않은 문법의 
실례가 있다. 

class SomeClass : public QObject { 

Q_OBJECT 
public slots: 

SomeClass( QObject *parent, const char *name ) 

: QObject( parent, name ) { } // WRONG 
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}; 

8) 속성들은 각각의 get 와 set 함수들을 포함하는 공개절앞에서 선언되여야 한다 
형 정의와 매개의 얻기와 설정 함수들을 포함하는 public 절 안이 나 뒤에 첫 속성을 선 
언하면 기대한대로 동작하지 않는다. moc 는 함수들을 찾을수 없거나 형을 해결할수 없 
다고 통보한다. 여기에 옳지 않은 문법의 실례가 있다. 
class SomeClass : public QObject { 

Q_OBJECT 

public: 


Q_PROPERTY( Priority priority READ priority WRITE setPriority ) // WRONG 

Q_ENUMS( Priority ) // WRONG 

enum Priority { High, Low, VeryHigh, Very Low }; 

void setPriority( Priority ); 

Priority priority() const; 


}； 

클라스선언의 선두에 바로 Q _ OBJECT 뒤에서 모든 속성들을 선언함으로써 이 제한 
을 해결한다. 

class SomeClass : public QObject { 

Q_OBJECT 

Q_PROPERTY( Priority priority READ priority WRITE setPriority ) 

Q_ENUMS( Priority ) 
public: 

enum Priority { High, Low, VeryHigh, Very Low }; 
void setPriority( Priority ); 

Priority priority() const; 

}； 
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제 5 절. 사용자대면부콤파일러 uic 

이 절에서는 Qt GUI 도구일식의 사용자대면부콤파일러를 서술한다. uic 는 Qt 
Designer 에 의해 생성된 XML 로 된 사용자대면부정의 파일 (. ui ) 을 읽 어들이 고 대 응하는 
C ++ 머 리부파일 혹은 원천파일들을 창조한다. 또한 화상파일을 생성하여 C ++ 원천코드에 
생화상자료를 매몰한다. 

1. 선택 

1) 파일생성선택 
선언을 생성한다. 

uic [ options ] < file > 

실현을 생성한다. 

uic [options] -impl <headerfile> <file> 

• <headerfile> - 선언파일의 이름 
화상집 합을 생 성한다. 

uic [options] -embed <project> <imagel> <image2> <image3> ... 

• <project> - 프로젝 트이 름 

• <image[0..n]> - 화상파일 들 

편리상 uic 는 파생콜라스들용의 선언 혹은 실현그루터기들을 생성할수 있다. 

파생 콜라스선언을 생 성 한다. 

uic [options] -subdecl <classname> <headerfile> <file> 

• <classname> - 생 성 하려 는 파생 콜라스의 이 름 

• <headerfile> - 기 초콜라스의 선언 파일 
파생들라스실현을 실현 한다. 

uic foptions ] -subimpl < classname > < headerfile > < file > 

• <classname> - 생 성 하려 는 파생 콜라스의 이 름 

• <headerfile> - 파생 믈라스의 선언 파일 

2) 일반선택 

• -o file - 출력 을 stdout 이 아니 라 ’file’ 에 써 넣 는다. 

• -nofwd - 생성된 머리부파일에서 전용클라스들의 앞방향선언들을 빠뜨린다. 이것은 
클라스형정의 가 사용된다면 필요하다. 

• -tr func - 국제 화에 仕 UtfB(sourceText, comment) 가 아니 라 func(sourceText, comment) 를 
사용한다. 
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2. 사용법 

uic 는 make 에 의해서만 호출된다. 

여기에 GNU make 만 사용한다면 makefile 을 사용할수 있다. 

% 上 : %.ui 
uic $< -o $@ 

%.cpp: %.m 

uic -impl $*.h $< -o $@ 

이식가능하게 쓰려면 다음 형식의 개별적인 규칙들을 사용할수 있다. 

NAME.h: NAME.ui 
uic $< -o $@ 

NAME.cpp: NAME.ui 
uic -impl $*.h $< -o $@ 

자기의 SOURCES (자기가 좋아하는 이름을 대신한다)변수에 NAME.cpp 를，자기 
의 OBJECTS 변수에 NAME . o 을 추가하는것을 잊지 말아야 한다. 

( C ++ 원천파일을 .cpp 로 이름짓는것을 좋아해도 uic 는 고려하지 않으므 

로 . C ，. cc , . CC , .cxx 혹은 자기에게 좋으면 지어는 .C++ 를 사용할수 있다.) 
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